User Device Driver 

Implementation 

in the Real-Time 

Disk Operating 

System (RDOS) 



093-000231-00 



For the latest enhancements, cautions, documentation 
changes, and other information on this product, please see 
the Release Notice (08 5 -series) supplied with the software. 



Ordering No, 093-000231 

©Data General Corporation, 1972. 1974, i97S, 1979 

AH Rights Reserved 

Primed in the Uniiecl Suites of America 

Revision 00. March 1979 

Licensed Material - Properly of Data General Corporation 



NOTICE 

Duia General Corporation (DGC) has prepared this manual for use by DGC personnel, licensees, 
and customers. The information contained herein is the property of DGC and shall not be 
reproduced in whole or in part without DGC prior written approval. 

DGC reserves the right to make changes without notice in the specifications and materials 
contained herein and shall not be responsible for any damages (including consequential) caused by 
reliance on the materials presented, including but not limited to typographical, arithmetic, or listina 



User Device Driver 

Implementaiion 

in ihe Real-Time 

Disk Operaiing 

Svsiem (RDOS^) 

093-000231 



Revision Hisiorv 



017-000002 

Original Release - September, 1972 

Firsi Revision - November. 1972 

Second Revision - January, 1974 

Third Revision - February, 1975 

093-000231 

Original Release - March. 1979 



This revision changes only the pari number, the text is identical to manual 
017-000002-03. 



The following are trademarks of Data General Corporation. Westboro. Massachusetts; 

U.S. Registered Trademarks ^ Trademarks 

CONTOUR I INFOS NOVALITE DASHER 

DATAPREP NO\'A SUPERNOVA DG/L 

ECLIPSE NOWaDISC microNOX'A 



TABLE OF COiNTENTS 
CHAPTER 1 - RDOS DRIVER IMPLEMENTATION 

Introduction i i 

Characteristics of Interrupts ....................... i_i 

Interrupt Priority Scheme '.[ l-o 

Interrupt Dispatch Program . 1-4 

Device Control Table (DOT) Structure .............'.*.*.*.* 1 -7 

User File Table (LTT) Structure .'.'[.'.*.* 1- 1 1 

CHAPTER 2 - OPERATING SYSTEM DEVICE IMPLEMENTATION 

General 9 i 

Reentrant Coding and Subroutine Linkage ....'.... 2-3 

General Subroutine Package (GSUB, MGSUB, BGSUB, AG SUB) . . 2-7 

Save State Variables 9_t t 

Restore State Variables, Return a Frame 2-11 

Move a Byte String .9-11 

Load/Store a Byte 2- 1 1 

Exclusive Or . 2-i 2 

Clear a Block of Core 2-12 

Move a Word String 2-l'> 

Compare Two Word Strings .2-1'? 

Single/Double Precision Integer Divide 2-13 

Set/Reset Bits in a Word ......................' 2-13 

Mapped xMove a Byte String 2-13 

Mapped Load and Store Bytes .................... 2-14 

Mapped Move a Word String 2-14 

Mapped Clear a Block of Core ................... 2-15 

Generalized I/O Routines. .....................'.'.'].' 2-16 

Open (OPNO, OPNI) .................*.*'*.'].*].'] 2-20 

Close (CLSO, CLSI) ..................'.'!.**.'.']* 2-21 

Read Sequential (RDS) ......................... 2-21 

Read Line (RDL) ••.......................,..' 2-2^ 

Write Sequential (WRS) ....................]].' 2-23 

Write a Line (WRL) .......................*'*.' 2-'?3 

Get Master or E)efault Directory Name (GMDIR/ 
GDIRS) .................................. 2-24 

I/O Buffer Module (lOBUF) ................,*.**.'*'*.* 2-25 

Common Input Device Interrupt Service (CISER) ....... 2-26 

Common Output Device Interrupt Service (COSER, 
STOUT) ................................. 2-27 

Add a Bead to the String (ENQUE) ................. 2-27 

i 



CHAPTER 2 - OPERATING SYSTEM DEVICE IMPLEMEiNTATION (Continued) 

Terminate Bead from Head of List (DEQRQ) .......... 2-27 

Remove a Bead from the aring (DEQUE) ............ 2-28 

Partial Input Interrupt Service (FINP) .............. 2-28 

Input a Character to the I/O Riffer (IHJF). ........... 2-29 

Priority Enqueue a Bead (PENQU) ................. 2-29 

Priority Enqueue a Bead and Input to an I/O Buffer 

(XIBUF) .... 2-29 

Output a Character from the I/O Buffer (OBUF) 2-30 

I/O Buffer Management 2-30 

Retrieve a Character from the I/O Buffer (RCHR) .2-31 

Add a Character to the I/O Buffer (ACHR) 3-32 

Declaring the DOT Address 2-32 

Creating a Peripheral Device Entry in a Directory 2-33 

Updating the System Libraries 2-34 

Creating a System Queue Entry 2-37 

System Generation 2-37 

Practical Hints for System Device Driver Implementation .... 2-38 

Elements Required in User- Written I/O Routines ...... 2-38 

Examination of a System Device Driver 2-39 

CHAPTER 3 - USER PROGRAxM SERVICED INTERRUPTS 

Servicing User Interrupts 3_]_ 

User Device Driver Implementation at Run Time ...... 3-1 

Identify a User Interrupt Device (. IDEF) 3-2 

Exit from a User Interrupt Routine (.UIEX) .......... 3-4 

Remove User Interrupt Servicing Program (. IRMV) ..... 3-4 

Set the Data Channel Map (.STMAP) ............... 3.5 

Modifying the Current Interrupt Mask (. SMSK) ........ 3-6 

Writing User Power Fail Service 3-6 

Exit from a Power Fail Service Routine (.UPEX) ....... 3-8 

User Programmed Clock .......................... 3_8 

Define a User Clock (.DUCLK). .................. 3.8 

Remove a User Clock (.RUCLK). ................. 3-9 

Examples of User Serviced Interrupts ................. 3-10 

Analog to Digital Converter .................... 3- 10 

External Interrupt Recognition ................... 3-16 

Multiprocessor Communications Adapter ........... 3-20 



ii 



Licensed Material - Proper^/ of Data General Corporation 
CFLIPTER 1 
RDOS DRIVER IMPLExMENTATION 
INTRODUCTION 

In all real time computer control systems, the CPU reacts to input data from a real 
world en\dronment and provides output data to correct or control the environment. 
The incoming data is normally the result of a process device interrupt or an input - 
output operation completion interrupt. In general these interrupts differ from one 
another only in the way in which they are serviced. 

\^'hen a significant event occurs, a signal is transmitted to the computer as an 
interrupt requiring a special subroutine to take appropriate action. Interrupts are 
usually assigned in order of urgency or priority, so that if t^,vo interrupts occur at 
the same moment, the more important interrupt is serviced first by the computer. 

How well a computer is able to respond to interrupts generally determines the max- 
imum capability of the real time system. A significant element in the responsive 
abilit>^ of any real time system is the inclusion of a powerful and flexible multi- 
priority interrupt control program. 

This document outlines the methods of adding customer -assignable multi -priority 
sei^icing routines. These device drivers can be included as part of the resident 
RDOS operating system or they can be implemented as part of the user application 
program and attached to the interrupt dispatch program. 

Statements in this manual wliich refer to RDOS can, unless otherwise qualified, be 
understood to apply to both mapped and unmapped versions of the operating system 
running in either NOVA® * or ECLIPSET'^ ^* computer environments. 

CHARACTERISTICS OF INTERRUPTS 

Interrupts can be generated by conditions internal to the computer hardware itself 
(power monitor option), or by events which originate in the plant or the environ- 
ment that is being controlled (an external hardware interrupt like an analog -to - 
digital converter completion). 



"^NOVA is a registered trademark of Data General Corjwration, Southboro, Mas- 
sachusetts. 

^''ECLIPSE is a trademark of Data General Corporation, Southboro, Massachusettf 
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CHARACTERISTICS OF INTERRUPTS (Q3ntmued) 

Non -process interrupts may be caused by an error condition being detected, an 
interval timer run-dow, an input -output (I/O) complete interrupt, etc. The I/O 
interrupt is characterized by the completion of an I/O device operation such as 
a paper tape or disk storage transfer function, which may involve the reading or 
writing of one character or word in the case of program control or multiple words 
m the case of data channel operation. Hie concept of this t^^pe of interrupt is based 
on the importance of keeping I/O devices active, thus impro\ang job throughput. 

Process interrupts reflect process conditions which have been detected and which 
require an immediate change in program execution, such as may be caused by the 
closing of an electrical switch or contact, a rise in temperature above a pre- 
scribed limit, etc. 

LNTERRUPT PRIORITY SCHEME 

There are several ways in which priorities are determined for or assigned to 
devices on the I/O bus. An elementary/ priority is established by the hardware 
for devices that are requesting interrupts simultaneously: among those de\nces 
waiting with an active interrupt, the one which is physically closest to the processor 
on the bus is at the highest priorit\^ 

The most significant method is to specif>r which devices can interrupt a service 
routine currently in progress. This is done by using a 16 bit priority mask. Each 
device is wired to a particular bit of this mask word. 

By means of the mask word, the intermix ser\^icing program can inhibit specified 
levels of interrupts and thus establish any prioritj^ structure. The biggest ad- 
vantage of this means of priority level control is a near optimum priority response. 
To guarantee minimum response time to an interrupt, the mask bit assigned to 
this device should not be set for long periods of time. Through the judicious use 
of masking, data channels can be kept functioning for the transmission of data 
into and out of core storage while process interrupts are prevented from occurring. 
The function of masking is used to delay recognition of an interrupt (the imTOrtant"" 
fact is that the interrupt is not lost). 
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INTERRUPT PRIORITY SCHEME (Continued) 

The interrupt mask assignments for standard devices supplied by DGC are as 

follows: 

^\bsk Assigned Devices 

3 $TTO, TTI, QTY (4060 quad multiplexer) 

7 $PTP 

^' $PLT, MCAT (4038 multiprocessor communications 

adapter transmitter), MCAR (4038 multiprocessor com' 
munications adapter receiver) 

10 $LPT 

2i~ $DPO, $DP1 (IPB dual processor full duplax link) 

617 moving head disk 

717 fixed head disk 

^ ^717 IPB half -duplex directory interlock 

1737 $PTR 

^777 $CDR, magnetic tape, cassette 

Although slower devices are assigned to higher numbered bits in the mask, there is 
no established priority, since the program can use any mask configuration. All 
devices wliich have their mask bits set will not cause an interrupt and are there- 
fore regarded by the program as being of lower priority. 
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INTERRUPT PRIORITY SCHEME (Continued) 

An example of multi -level priority interrupt servicing is shown below for an 
environment including a Teletype® *, plotter and fixed head disk. 



Program Mask 

Fixed Head Disk Interrupt 717 

Plotter 13 

Teletype Interrupt 3 

Main Line User 

INTERRUPT DISPATCH PROGRAM 



At the precise moment an unmasked interrupt has been detected at the hardware 
level, the hiterrupt Dispatch program (INTO) receives control to service the 
interrupt. The INTO program is assembled as an integral portion of the RDOS 
system and resides in core at all times. 

The INTD program is designed to do the following: 




•Identify the interrupting device** 
•Save the machine status and all** 
addressable registers 
•Set up the new priority mask'*'* 



•Direct control to the proper servicing 
routine ** 

•Restore the previous priority mask ** 
•Restore the machine status and registers 
•Return to the interrupted program 



^Teletype is a registered trademark of Teletype Corporation, Skokie, IlHnois. 
** This function is performed by the VCT instruction on ECLIPSE systems. 
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INTERRUPT DISPATCH PROGRAM (Continued) 

The L\TD program directs control to the correct servicing routine by using the 
correct entry in the system Interrupt Branch Table (ITBL). ITBL is a 66 word 
table, with displacements corresponding to device codes 1-63. That is. aevice 
code I is found at displacement 1 (i.e. , at "ITBL"). Each displacement corres- 
pondmg to a device in the system contains the address of that device's DCT, All 
other displacements contain -1, 
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interrupt 




Interrupt 

Service 
Routine 



Flow of Control During Interrupts 
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DEVICE CONTROL TABLE (DCT) STRUCTURE 

Each device defined in the RDOS s^/stem must have the address of its DCT included 
in the interrupt branch table (ITBL) as explained in later sections. For interrupt 
servicing routines defined in the user's area, only the first three entries are 
needed. Words 7-26 of the DCT differ for byte and block oriented devices. 



Word 0, DCTBS; 



In revisions prior to 04, this displacement continued the 
address of an eight word interrupt state save area not used 
by RDOS but reserved for compatibility with RTOS. In re- 
vision 04, bit zero is set to 1 if this device uses the data 

channel. 



Word 1. DCTMS; 



Word 2, DCTIS: 



Word 3, DCTCH: 



MNEMONIC 


BE 


DCCPO 


15 


DCCGN 


14 


DCIDI 


13 


DCCNF 


12 


DCTO 


11 


DCxKEY 


10 


DCNAF 


9 


DCRAT 


8 


DCPCK 


7 


DCLAC 


6 


DCSPO 


5 


DCFWD 


4 


DCFFO 


3 


DCLTU 


2 


DCC80 


1 



DCSFC 



Mask Word. Clear a bit for every priority considered 
higher than the priority of this device. The devices cor- 
responding to the priority bits that are left cleared will be 
permitted to interrupt the current device. For a complete 
set of system mask words, see the list provided previously 
in INTERRUPT PRIORITY SCHEME . 

Address of the device interrupt ser^'ice routine. 

Device characteristic word. A list of device characteristics 
is given in the following table. 

MEANING 

Device requiring leader /trailer 
Device requiring tab simulation 
Device requiring operator intervention 
Device requiring form feed simulation 

Teletype output device 

Keyboard input device (uncontrollable) 

Device requiring nulls after form feeds 

Device requiring rubouts after tabs 

Device requiring even parity check on input, 

even parity computation on output 

Device requiring line feeds after carriage returns 

Spoolable de\4ce (LPT, FTP, PLT, TTO) 

Full word device (any size greater than a b}^e). 

Form feed sent on . OPEN 

Cbnvert lower to upper case ASCII 

Read 80 columns on input if set, 72 if reset. Send 

80 characters on output, 72 if reset. 

Spooling enabled if set to 1, disabled if reset 
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DEVICE CONTROL TABLE (DCT) STRUCTURE (Continued) 
Word 4, DCTCD: Device code. 



Word 5. DCTEX: 



Word 6, DCTUT: 



Address of variable I/O instruction routine (reserved but 
unused on ECLIPSE systems.) 

Address of the device command dispatch table; bit set 
implies disk device. One entry for every RDOS I/O function. 
TTie table order must correspond exactly to die order of the 
function given below. Each entry is an address to the routine 
implementing the named RDOS function. If the device does 
not permit a command, a-1 should be entered in place of 
the address. 



MNEMONIC DISPLACEMENT 



OF 

CF 

RS 

RL 

RR 

WS 

WL 

WR 

OA 

RO 

EO 

TO 





1 
2 
3 

4 

5 

6 

7 

10 

11 

12 

13 



MEANING 

Open a file for reading/writing by one 

or more users. 

Close a file. 

Read Sequential 

Read Line 

Read Random 

Write Sequential 

Write Line 

Write Random 

Open a file for appending 

Open for reading orJy 

Exclusive read/write open 

Transparent (exclusive) open (does not 

alter file access info) 



The following words, 7-26. are used with b>l:e -oriented devices. 

Word 7. DCTST: Address of the device start routine. The device start 

routine specification is as follows: 



Word 10, DCTBC: 
Word 11, DCTBP: 
Word 12, DCTPC: 



Input device: Activate the device and return 
Output device: Character is passed in A CD 

Size of device buffer in bytes. 
Byte pointer to device buffer. 
Base level (program) b}rte count. 
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DEVICE CONTROL TABLE (DCT) STRUCTURE (Continued) 



Word 13, DCTPP: 
Word 14, DCTQL: 
Word 15. DCTDP: 
Word 16, DCTDC: 
Word 17, DCTQS: 
Word 20, DCTBD: 

Word 21, DCTQP: 
Word 22, DCTTl: 
Word 23, DCTT2: 
Word 24, DCTTO: 
Word 25, DCTCC: 
(Word 25, DCTPR: 
W^ord 26, DCTLC: 
(Word 26. DCTLK: 
Word 27, DCTON: 
Word 30, DCTOF: 
Word 31, DCTSL: 
Word 32, DCTOP: 
Word 33, DCTT3: 



Base level (program) b\'te pointer. 

Link to device request bead chain. 

De\dce data b\T:e pointer. 

Device data count. 

Bead status word (described in GENERALIZED I/O ROUTINES). 

Bead address (i. e. , the starting address of the first bead, 
word 14) 

Device queue starting address (initially -1). 

First temporary for device control. 

Second temporary for device control. 

Timeout constant for input devices. 

Output device column counter. 

Echo device DCT pair pointer, TTI only.) 

Output device line counter. 

Link to TTR, TTI DCTs only. ) * 

"ON" DCB address for spooler. * 

"OFF"DCB address for spooler. * 

Link to next spoolable device DCT (-1 terminates the chain). 

Device queue starting address for operator messages. 

Temporary for operator message status word whose bits 
are defined as follows: 



'set by RDOS. 
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DEVICE CONTROL TABLE (DCT) STRUCTURE (Q)ntinued) 

Bit Meaning 





15 



Set to 1 if "!" has been received. 
Set if "F" or "B" has been received. 



The following words. 7-26, are used with block transfer devices. 
Word 7, DCTRD: Read a Block. 

High order portion of numter of blocks on the device. 
Device start routine. 



Word 10, DCNBl: 
Word 11, DCSTR: 
Word 12, DCDST: 



Word 13, DCCRQ: 
Word 14, DCTSZ: 
Word 15, DCTRL: 
Word 16, DCTRN: 
Word 17, DCTIN: 
Word 20, DCTRS: 
Word 21, DCNBK: 
Word 22, DCTNS: 
Word 23, DCTNH: 
\¥ord 24, DCTMX: 



Set DST word (used for logical -to -physical disk block 
address computation). 

Current request pointer. 

Routine to perform disk sizing (not used by MTA/CAS). 

Read last block. 

Read next block. 

Device initialization routLne. 

De\'lce release routine. 

Number of blocks on de\dce (low order portion; see DCNT31). 

Number of sectors per track. 

Number of heads per unit. 

Hash frame size (one of the foUowLng): 

Mo^rmg Head Disk T\T3e Frame Size (octal t 

4047 

4048 

4057 

4231 



103 
155 
255 
255 
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DEVICE CONTROL T.\BLE (DCT) STRUCTURE (Continued) 



Word 25, DCHMP: ■ 
Word 26, DCHN^I: 



Aegreirace 


Fixed 


Frame Size (decimal) 


Head Storaq-e 




12SK 




7 


256K 




13 


3S4K 




23 


512K 




31 


640K 




41 


76SK 




47 


896K 




53 


1024K 




61 


1152K 




71 


12S0K 




79 


14S0K 




89 


1536K 




97 


1664K 




103 


1792K 




113 


1920K 




113 


2048K 




127 



(For a description of hashing under RDOS, see 
the Stand Alone Disk Editor manual. 093-000092, 
Appendix B. ) 

First slot in data channel map (mapped systems only). 

Number of slots needed in data channel map (mapped 
systems only). 



USER FILE TABLE (UFT) STRUCTURE 

User File Tables (UFTs) are tables used by the operating system to record file and 
device information for each file or device that is opened. There is one UFT for 
each channel defined to be available to a user program (via the . COMM TASK state- 
ment or RLDR switch /C). These tables reside in system space in mapped environ- 
ments, and between N^AX and the operating system in unmapped single program 
environments (see Chapter 6 of the RDOS Reference Manual for further information 
about the location of these tables). UFT structure is defined in FARU. A sub- 
section of each UFT, termed the UFO, is also defined in FARU; it consists of words 
0-21g of each UFT. The structure and mnemonic assignments of UFTs are as 
follows: 
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Words to 4, UFTFN: 
Word 5, UFTEX: 
Word 6, UFTAT: 
Word 7, UFTLK 
Word 10, UFTBK: 
Word 11, UFTBC 
Word 12, UFTAD: 
Word 13, UFTAC: 
Word 14, UFTYD: 
(Word 14, UFLAN, Unks 
Word 15, UFTHIvl 
Word 16, UFTPl: 
Word 17, UFTP2: 
Word 20, UFTUC: 
Word 21, UFTDL: 
Word 22, UFTDC: 
Word 23, UFTUN: 
Word 24, UFCAl: 
Word 25, UFTCA: ^ 
Word 26, UFTCB: 
Word 27, UFTST: 



Word 30, 
Word 31, 
Word 32, 
Word 33, 
Word 34, 
Word 35, 
Word 36, 
Word 37, 
Word 40, 



UFEAl: 

UFTEA: 

UFNAl: 

UFTNA: 

UFLAl: 

UFTLA: 

UFTDR: 

UFFAl: 

UFTFA: 



File name. 

File extension. 

File attributes. 

Link access attributes word. 

Number of the last block in the file (disk file). 

Number of b\^es in last block (disk file). 

Device address of first block (disk file). 

Year /day last accessed. 

Year/da^/ created, 
only: Link alias name. ) 

Hour /minute created. 

Temporary location used by the system. 
Temporary location used by the s\'Stem. 

File use count. 

Link to DCT, 

DCT address. 

Unit number (disk file). 

Current block address high order (disk file). 

Current block address, low order (disk file). 

Current block number (disk file). 

File status: 

STER 1B15 ERROR DETECTED 

STIOP 1B14 I/O IN PROGRESS 

^FWR 1B13 FIRST WRITE FLAG 

STDIU 1B12 DIRECTORY IN USE 

STRWD mm OPENED FOR MTA RAV BLOCK 

ST7T 1B08 7 TRACK MAG TAPE 

STINI 1B01 NO INIT FLAG 

STCMK mm SET = READ (BLKIO)- 

INIT/RE LEASE BIT 
STOPN 1B2 DOB OPENtED (MTA) 

Entry's block address, high order (disk file). 
Entry's block address, low order (disk file). 
Next block address, high order (disk file). 
Next block address, low order (disk file). 
Last block address, high order (disk file). 
Last block address, low order (disk file). 
S\'S.DR DCB address. 
First address, high order, (disk file). 
First address, low order, (disk file). 



Displacements in UFTs which refer to disk files are set to zero when the opened 
file described by the UFT is not a disk file. 
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CHAPTER 2 

OPERATING SYSTEM DEVICE IMPLEMENTATION 
GENERAL 

Device driver suprort can be provided by the operating system in one of two ways: 

1) by incorporating the driver into the operating system at 
source program level; 

2) by identifying the driver to the operating system at run time 
via system call . IDEF. 

The first of these means is the most efficient means of providing device interrupt 
service, since the same routines and data bases used by system devices are made 
available to the user device. This method requires a detailed understanding of 
system data bases, service routines, and device driver structure. These items 
are described in Chapters 1 and 2. 

The second method, described in Chapter 3, is somewhat less efficient since it 
entails a duplication of certain functions by the user which are already provided 
by the system. Nonetheless, this method is comparatively simple to use, and it 
can be applied to both character and data channel devices. 

The following is a list of I/O devices, their names and their device codes, that are 
standard system devices. 

Device Name Device Device 

Code 

$CDR card reader, primary controller 16 

$CDR1 card reader, secondary controller 56 

CTn DGC cassette unit n, primary controller 34 

CTln DGC cassette unit n, secondary controller 74 

DKO DGC NOVADISC, primar>^ controller 20 

DKl DGC NOVADISC, secondary controller 60 

DRi moving head disk, n = -3; primary controller 33 

D% moving head disk, n = 4 -7; secondary controller 73 

$DFI input dual processor linV 40 

$Dro output dual processor L. k 41 

$LFr line printer 17 

ILPTl second line printer 57 

MCAR first multiprocessor communications adapter 

receiver 7 

MCAR I secont' multiprocessor communications adapter 

receive^ 47 
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ration 



Device Name 

MCAT 

MCATl 

MTn 

MTln 

$PLT 

SPLTl 

$PTP 

$PTP1 

$PTR 

SPTRl 

QTY 

RTC 

$TTR/$TTI 

$TTR1/$TTI1 

$TTP/$TTO 
$TTP1/$TT01 



De¥ice 

first multiprocessor communications adapter 
transmitter 

second multiprocessor communications adapter 

transmitter 

magnetic tape unit n, primar}^ controller 

magnetic tape unit n, secondary controller 

incremental plotter 

second incremiental plotter 

high speed paper tape punch 

second high speed paper tape punch 

high speed paper tape reader 

second high speed paper tape reader 

type 4060 as^mchronous data multiplexor 

real time clock 

Telet>T)e reader keyboard or display terminal 
keyboard 

second Telet>^pe reader keyboard or display 
terminal keyboard 

Telet>T3e printer /punch or terminal screen 
second Teletype printer/punch or terminal screen 



Device 
Code 



46 
22 

62 

15 
55 
13 
53 
12 
52 
30 
14 

10 

50 
11 
51 



Device code 2 is not available to mapped RDOS (MRDOS) user devices, and device 
RTOS or MRTOs!'" "°' ^''^'^^''^' ^°'' """^ ^^' ^^^ '"'"" '""^''^^ '"^""'"^ ^° ^^ ™^^^ 

Changes to RDOS to incorporate another device into the operating system can be 
made at the source program level. This section describes briefly the required 
changes to add a device. However, to completely understand the process of adding 
a demce driver, the user may need to review Hstings of those RIX)S programs 
mentioned later that require modification. TTie source programs required are 
availaole from DGC. 

During f^ull initialization of the system, names of all single -file peripheral devices 
m the system are added to the system file director)., SYS. DR. Tiie device name 
%viU be entered only if the user has forced the driver to be load-d 
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The general procedure for adding a device driver at source level is as follows: 

. declare a DCT entry for the device 

. enable entry of the device name in SYS. DR 

. update the system library 

. create a system queue entr\' 

. perform a system generation and load. 

Hie following sections describe each of these steps. 
REENTILINT CODING AND SUBROUTINE LINKAGE 

One of the basic problems that arises in multilevel priorit^r interrupt programming 
is that different levels require use of the same subroutine. This means that a 
higher priority interrupt could interrupt a lower priority one before it has com- 
pletely used a common subroutine and argument pointers, temporary core storage 
locations, etc. , with the result that the return point for the lower level interrupt 
would be lost. Reentrancy, then, is defined as that propert\r of a subroutine where- 
by use of the routine does not modifv^ any of its locations; temporary values are 
stored outside the routine. Thus one user may be prevented temporarily from 
completing use of a reentrant routine because a higher priorit>^ user needs to use it 
When the higher priority user has finished with the routine, the lower priority user 
com^pletes Ms use of the routine at the point where he was interrupted. 

A method of reentrant coding using a system stack has been devised for RDOS to 
allow one subroutine to be entered at any time and from any interrupt level without 
loss of results. Hie operating system has several stacks used for the saving of 
state variables whenever a call to a system subroutine is executed. The structure 
of NOVA RDOS stacks and stack frame differs from those employed on ECLIPSE 
systems. On NOVA systems, each of these stacks is of a fixed length and stack 
frames are defined in the same manner for each stack. The stack frame is the 
basic increment of storage on a system stack. 
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REE>rrRANT CODING AND SUBROUTINE LINKAGE (Continued) 

Eac± NOVA system stack consists of 10 octal frames, each stack frame is 16 octal 
locations in length, and the locations in each frame have the following definitions: 



Displacement 
-1 


1 

2 

3 

4 



Mnemonic Contents 

SP Pointer to the beginning of this stack frame 

(i. e. , to RTLOC) 
RTLOC Return location. 

ACO ACO contents if this routine calls another 

routine, 
ACl ACl contents if this routine calls another 

routine. 
AC2 AC2 contents if this routine calls another 

routine. 
TMP First general purpose storage location for 

use by this routine. 



13 
14 



MXTMP Eighth and last general purpose storage 

location. 
VRTN Overlay virtual address if the caller is a 

system overlay. 



2-4 



Licensed Material - Propem- of Data General Corporation 

REEynL\XT CODING AND SUBRQUTIKE LINKAGE (Concinued) 

Tlius if system subroutine A called system subroutine B, a portion of the system 
stack would contain the following items: 



'A" calls "B" 



A ' s return PC 



A's accumulators 



A's temporaries 




CSP 







MXTMP 



A's virtual address VRTN 



RTLOC 



B's temporaries 



AC2 

TMP 

MXTMP 



B's virtual address VRTN 



NOVA RDOS Stack Segment 



Notice that B's return and AC displacem.ents would not be used until and unless B 
calls out to another routine. Furthermore, A's AC storage and return storage 
locations are known to B as OAQi and ORTN, and can be used by B, should B 

wish to return AC parameters to A. Consult PARS for a complete list of system 
stack mjiemonic definitions. 

RDOS maintains a pointer for the current system stack frame in location 10, CSP. 
Linkage to save subroutine state variables on a system stack and restore these 
variables is provided by routines contained in a utility package called GSUB (MGSUB/ 
AGSUB/BGSUB). The save/restore routines are entitled SAV, SRTN, and RTN. 

2-5 



Licensed Material - Property of Data General Corporation 
REENTRANT CODLNG AND SUBROUTLNE LINKAGE (Continued) 

Calls to these routines are defined in the system parameters as RSAVE, SRTRN and 

RTRN, 



On ECLIPSE systems, the RTN machine language instruction is used for system 
stack frame popping; a macro, RSAVE, is defined using instruction SAVE for 
stack pushing. This permits stack frames to be variable in length and speeds up 
the use of the stack. The current frame pointer, CSP, is maintained in location 41. 
Each system stack in a ECLIPSE environment is 250 octal words long; the interrupt 
stack IS only 100 octal words in length. Hie fixed portion of each ECLIPSE system 
stack frame is defined as follows: 



Displacement 
-4 

-3 

-2 

-1 



1 
2 



Mnemonic 
OACO 

OACl 

0AC2 

OSP 

ORTN 
OVRTN 

TMP 



Contents 

ACO contents if this routine calls another 

routine. 

ACl contents if this routine calls another 

routine. 

AC2 contents if this routine calls another 

routine. 

Current stack pointer (CSP) for this frame 

if this routine calls another routine. 

PC contents if this routine calls another 

routine. 

Overlay virtual address if the caller is a 

system overlay. 

First temporary' storage location of the called 

routine (if this routine calls out). 

Additional variable storage of called routine. 
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REENTRANT CODING AND SLmROUTINE LINKAGE (Continued) 

Thus if system subroutine A called system subroutine B, a portion of the system 
stack would contain the following items: 



•A"caUs "B" CSP 



A's accumulators 



A's CSP 



-•-: A's return PC 



Ox\Cn 

OSP 
ORTN 



A's virtual address OVRTN 



B's temporaries 



TMP 



ECLIPSE RDOS Stack Segment 



GENERAL SUBROUTmE PACKAGE (GSUB, MGSUB, BGSUB, AGSUB) 

GSUB (MGSL^, BGSUB, AGSUB) is a core resident module vvhich contains a series of 
utilities for the system's use; GSUB is used by NOVA RDOS, MGSUB is used by 
NOVA mapped RDOS (MRDOS), BGSL^ is used by unmapped ECLIPSE RDOS, and 
AGSUB is used by mapped ECLIPSE RDOS. These utilities can be called by user- 
routines and are used extensively by the system in such areas as device drivers 
(e.g. , card reader) and overlays (e.g. , RINGl and RING2). Each of these utilities 
is self-contained, i.e. , none of them calls out to other routines and none of them 
save variables outside a system stack frame (except the byte -handling and compare - 
word routines, as noted later). The following list gives the entry names and uses 
of each of the utilities in the GSUB, MGSLtB, BGSUB, AGSUB modules. 

The column labeled "CPU" describes the type of computer system which can issue 
this call. When a call is appropriate to a mapped environment (e. g. , MVMFW) 
yet is listed as being issuable in a non-mapped system, that call is equated with a 
similar call (e.g. , M\''\¥D) which is appropriate in an unmapped environment. This 
permits certain calls like MVMFW to be issued in both environments. 
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GENERAL SUB ROUTINE PACKAGE (GSUB. MGSUB, BGSUB> AGSUB) (Continued) 
CPU types and their keys are as follows: 

1 - Unmapped NOVA computer. 

2 - Mapped NOVA computer. 

3 - Unmapped ECLIPSE computer. 

4 - Mapped ECLIPSE computer. 



€) 



O 
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NA.\IE 



CPU 



RSAVE 


1,2 


RETX 


1, 2 


MVBYT 


1,2,3,4 


MTMVB 


1.3 


MFMVB 


1,3 


LDBT 


1,2 


LDCHR 


1 2 


STBT 


1 2 


STCHR 


1,2 


MLDUr 


1,2,4 


MSTBT 


1.2,4 


MVWD 


1.2,3,4 


MBumv 


1.2,3,4 


MFMVW 


1,2,3,4 


MTMVW 


1.2.3,4 


CLEAR 


1,2,3,4 


MCLR 


1.2,3.4 


CMPWD 


1,2,3,4 


DIVI 


1,2,3.4 


DIVD 


1,2,3,4 


MPY 


1.2,3,4 


MPYAD 


1,2,3,4 


ROX 


1 2 


SETFL 


1,2 


RSTFL 


1,2 


SRTN 


1 2 


MBLK 


2.4 


SSOVF 


3,4 



USE 



Save state variables on a system stack. 

Restore state variables, return the frame to the system stack. 

Move a b^-te strmg. 

Move bytes with a mapped to address. 

Move bytes with a mapped from address. 

Load a byte. 

Load a b\^e. 

Store a b^te. 

Score a byte. 

Load a byte. 

Store a b\te. 

Move a word string. 

Move words with both addresses mapped. 

Move words with a mapped from address. 

Move words with a mapped to address. 

Set a block of core to all zeroes. 

Clear a block of words with a mapped starting address. 

Compare two word strings. 

Perform single precision integer divide. 

Perform double precision integer divide. 

Perform single precision integer multiply. 

Perform double precision integer multiply. 

Perform an exclusive or. 

Set bits in a word to one. 

Reset bits in a word to zerx). 

Restore current state variables and do not return a frame 

to the system stack; return to the immediate caller (not to 

the address stored in RTLOC). 

Convert a user address to a mapped address. 

Stack overflow handler. 



List of General Subroutines 
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GENERAL SUBROUTINE PACKAGE (GSUB, MGSUB, BGSUB, AGSUB) (Continued) 

Except for RSAVE, RETN and SRTN, each of these routines is called by means of 
an indirect call to a pointer witliin the calling routine containing the routine name, 
e.g. , a call to ROX would be performed in the following manner: 



. EXTN ROX 

JSR i. ROX 



.ROX: ROX 

RSAVE, RETN and SRTN are used frequently in tlie operating system routines, so 
tlieir entr>^ points have been stored in the RDOS page zero area at locations 3, 4, 
and 11 octal respectively. Calls to these routines are defined in the system param- 
eters (PARS or MPARS) as follows: 

RSAVE is a macro call defined in PARS for NOVA systems to the save subroutine 
whose address is stored in location 3: 

. M\CRO RSAVE 

STA 3, iCSP 

JSR §. SAV 

/O 

For ECLIPSE systems, the RSAVE macro is defined as follows: 

. KL^CRO RSAVE 
SAVE 



07 

/o 



f 1 + 1 



RETN = JSR i4 
SRTRN = JSR ill 



Use of these mnemonics is sufficient to invoke the routine. 

The following summarizes the inputs required by each General Subroutine Package 
routine and describes the outputs obtained upon return from each call. These 
routines are used extensively by the system; for example, the card reader driver 
uses CxMPm'D and RINGI (discussed in a foliowuig section) uses LDBT. Each routine's 
description (except RSAVE, RETN, and SRTN) presumes the existence of a pointer 
containing the routine name as illustrated above. 
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Save State Variables 



Calling sequence: RSAVE 



Output: 



AGO, ACl, and AC2 are saved on a stack frame and are 
returned unchanged to the caller. AC3 contains the address 
of a new stack frame. 



Restore State Variables, Return a Frame 



Calling sequence: RTRN 



Output: 



Accumulators AGO through AC2 are restored; program 
control returns to the caller. A frame is returned to the 
svstem stack. 



Gilling sequence: SRTRN 



Output: 



Move a Byte String 
Input: 



Accumulators AGO through AC2 are restored; program 
control returns to the immediate caller (i.e., not to the 
naxt higher level). The system stack pointer remains 
unchanged, since no frame is released. 



AGO, From byte pointer 
AGl, To hpie pointer 
AG2, Byte count 



Calling sequence: JSR § . MVBYT 



Output: 



Load /Store a Bvte 



Input : 



The specified byte string is copied to the destination string 
area. MVBYT cannot be called during interrupt servicing, 
since MVBYT is not reentrant. 



ACl, Byte pointer 

AGO, Byte (right adjusted) 



Galling sequence: JSR @ . LDGHR/. LDWT/. MLDBT (or . STGHR/. STBT/. MSTBT) 



Output: 



The specified b\te is loaded or stored. STCHR (STBT/MSTBT) 
cannot be called during NOVA interrupt servicing, since 
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Load /Store a B\^e (Continued) 

Output: they are not reentrant. 

Exclusive Or 

Input: ACl, First operand 

AGO, Second operand 

Calling Sequence: JSR § . ROX 

Output: The exclusive OR of the input operands is returned in ACi. 

Both ACO and AC2 are restored to their input values. 

Clear a Block of Core 

Input: ACO, Number of sequential words to be cleared to zeroes 

AC2, Starting (lowest) address of the block. 

Calling Sequence: JSR § . CLEAR 

Output: The specified block of core is cleared. ACO through x\C2 

are restored upon exit. 

Move a Word String 

Input: ACO, Starting address of the string to be copied 

ACi, Starting address to receive the string copy 
AC2, Number of words to be copied 

Calling Sequence: JSR § . MV^VD 

Output: The specified word string is copied to the specified recei\aiig 

core area. ACO through AC2 are restored to their input 
values. 

Compare Two Word Strings 

Input: ACO, Starting address of the first string 

ACI, Starting address of the second string 
AC2, Number of Words to be compared 

Calling Sequence: JSR i . CMPWD 

success return 
failure return 
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Compare Two Word Strings (Continued) 

Output: Hie word strings are compared. If equal, control returns 

to the success return; otherwise, control goes to the failure 
return. ACO through AC2 are restored upon exit. CMPWD 
cannot be called during interrupt servicing! since CMPWD 
is not reentrant. 

Single/Double Precision Integer Divide 

Input: ACO, more significant dividend word for double precision 

divide only 
x\Cl, less significant dividend word 

AC2, integer divisor 

Calling Sequence: JSR@ . DIVI (single precision) or 

JSRi . DIVD (double precision) 

Output: Quotient is returned in ACl, remainder in ACOe AC2 is 

restored upon exit. 

Set/Reset Bits in a Word 

Input: ACO, operand word whose bits are to be set to 1 (or reset 

to 0). 

ACl, bit mask 

Calling Sequence: JSRi . SETFL (.RSTFL) 

Output : Operand has all its bit positions set which correspond to 

bit positions set in the mask word. 

Mapped Move a Byte String 

There are two move byte string routines for mapped systems; one routine accepts a 
mapped "to" address, while the other accepts a mapped "from" address. The 
result accomplished by both routines is identical: the specified byte string is 
copied to the destination area. Neither of these routines is reentrant. 

The formats of the t\TO routines are as follows: 

1) Input: ACO, Mapped "from " byte pointer 

ACl, "To" byte pointer 
AC2, Byte count 

2-13 



Licensed Material - Property of Data General Corporation 
Mapped Move a B>rte String (Continued) 

Calling 

Sequence: JSR § . MFMVB 

2) Input: AGO, "From" b>n:e pointer 

ACl, Mapped "to " b>^e pointer 

AC2, B\^e count. 

Calling 

Sequence: JSR @ .MTMVB 

Mapped Load and Store B\n:es 

There are t^vo load/store b>^e routines for mapped systems; each routine accepts 
mapped hyrte pointer inputs only. Hie result accompHshed by both routines is 
Identical: the b}^e is loaded or stored where the mapped b}^e pointer specifies 
that It should be accomplished. xNeither of these routines is reentrant. 

The formats of the two routines are as follows: 

1) I^Put: ACl, Mapped b\T:e pointer 

ACO,- B\n:e to be stor^ (right adjusted) 

Calling 

Sequence: JSR @ . MSTBT 

2) hiput: ACl, Mapped b}l:e pointer 

Calling 

Sequence: JSR § . MLDBT 

Output: ACO, B}l:e (right adjusted) 

iMapped Move a W'ord String 

There are^three move .vord string routines for mapped systems. One routine accepts 
a mapped to ' address, another routine accepts a mapped "from" address, .vMle " 
the tmrd accepts both a m.apped "to" address and a mapped "from" address The 
result accompHshed by all three routines is identical: the specified word strino- 
IS copied to the specified receiving core area. ACO through AC2 are restored to 
tneir input values. 
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Mapped Move a Word String (Continued) 



The formats of the three routines areas follows: 



1) Input: 



Calling 
Sequence: 

2) Input: 



Calling 
Sequence: 

3) Input: 



Calling 
Sequence; 



ACO, Mapped starting address of the string to be copied 
ACl, Starting address to receive the string copy 
AC2, Number of words to be copied 



JSR § .MVMVW 

ACO, Starting address of the string to be copied 

ACl, Mapped starting address to receive the string copy 

AC2, NumJDer of words to be copied 



JSR § . MTMVW 

ACO, Mapped starting address of the string to be copied 
ACl, Mapped starting address to receive the string copy 
AC2, Number of words to be copied 



JSR i . MBMVW 



Mapped Clear a Block of Core 

Mapped systems may clear a block of core memory to zeroes by means of a 
routine which accepts a mapped starting address. The format of this call is as 
follows : 



Input: 



Calling 
Sequence: 

Output: 



ACO, Number of sequential (mapped) words to be cleared 
AC2, Starting (lowest) mapped address of the block 
Cell CPTAD contains the program table address 



JSR § . MCLR 

The specified core area is set to zeroes. ACO through AC2 
are restored upon exit. 



There also exist three sets of system I/O com.mands, modules entitled RINGl, 
RING2, and RINGS. Each of these m.odules is a system overlay, described in 
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Mapped Clear a Block of Core (Continued) 

the follom^ing section. 

GENERALIZED I/O ROUTINES 

The I/O modules (RINGl, RING2, and RINGS) provide a number of useful, general' 
purpose reentrant routines for handling b}?te I/O from any device, on input or 
output, using the program interrupt facilit>^ Entry names of the appropriate I/O 
routines are placed in each device driver dispatch table as required (see Device 
Control Table Structure, word 6). Each I/O module is a system overlay. 

The basic buffer philosophy is to maintain one or more fixed length buffers, with 
pointers and counters maintained to indicate the amount of data in the buffers and 
the current word input or output. A virtually unlimited number of buffers can be 
appended to the first buffer, with a four -word bead assigned to maintain status 
information and pointers for each additional buffer. 

An input device inputs to the buffer at interrupt time and outputs from the buffer 
at program base level. An output device inputs to the buffer at program base 
level and outputs from the buffer at interrupt time. 



OBUF 



IBUF 



interrupt 
level DP 




PP 

^^ program 

^ level 



) PC 







r 


\ 




PC / 






program 








level 








PP 
1 




K. 





-*- DP interrupt 

level 
DC 



Input Devices 



Output Devices 
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GENERALIZED I/O ROUTINES (Continued) 

Pointers PP and DP indicate the current slot in the buffer used for character storage 
or retrieval by the program and device respectively. Counters PC and DC indicate 
the current number of characters stored or retrieved from the buffers by the pro- 
gram and device respectively. Tlie inputting of data to the buffer by the pro- 
gram or device halts temporarily when the last buffer has been filled. WTien 
the program or dence retrieves the last buffer character, characters may once 
again be input to the beginning of the buffer. In the case of multiple buffers, 
each buffer becomes free to receive input as soon as the last character in that 
buffer has been retrieved by the program or de^/ice. 

When DC becomes equal to zero (after the last character in a buffer has been 
accepted by an output device), or when DC becomes non-zero (when a character 
is placed in a buffer by an input de^/ice). the task with pointer PP is readied. 

A virtually unlimited number of buffers can be appended to the first buffer, pro - 
viding the facilit>^ for unformatted stream I/O and substantially reducing system 
overhead. Moreover, in unmapped systems only, these additional buffers may 
exist in user program space as well as in system address space. Additiorial I/O 
buffers are appended to the first buffer by linking or stringing additional beads 
to the first bead. Each bead has a link to the next bead in the string; the termin- 
ating bead has a -1 link. 

One device bead consists of words 14 through 17 of the device's DOT. The 
structure of each bead is as follows: 

Word Link word 

Word 1 Data Pointer (DP) 

Word 2 Data Count (DC) 

Word 3 Bead status/mode word 

Succeeding beads, used by system tasks like echoing, are linked to by previous 
bead links. The first bead in the string is pointed to by DCTQP of the device's DOT. 

The status/mode bit definitions for word 3 of each bead are as follows: 

Bit Meaning 

IBO Ready the task after each character 

^^^ Ready the task upon request completion 

■^^2 I/O request made by the foreground 

■'•BS I/O request made by the tockground 

^^ Foreground operator message is outstanding 

-'■^•5 Background operator message is outstanding 

-^•^6 De^/ice opened 
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GENERALIZED I/O ROUTINES (Continued) 



Bit 

1B7 
1B8 

1B9 

1B12 
1B13 

IBM 
1BI5 



Meaning 

Device opened to the background 

Device opened to the foreground 

Common service routines should not start this device (e.g. , 

$CDR) 

Treat this buffer as a ring buffer when it becomes filled 

Buffer is being treated as a ring buffer 

Echo the character (TTI only) 

Request is completed (cleared by ENQUE routine) 



DCT 




, DCo 



DCn 
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GENERALIZED I/O ROUTINES (Continued) 

A brief description of the major routines and their calling sequences follows. More 
detailed information can be obtained by reviewing the listings of RINGl, RING2, 
and R1NG3. I/O buffer management functions are also provided by the RING I/O 
modules; these functions are discussed in the following section entitled I/O BUFFER 
MANAGEMENT. It is important to note that although buffer input/output is in 
b\te increments, devices transmitting larger data widths can use the same basic 
scheme. The card reader, for example, inputs its full word by calling for two 
consecutive b\rte inputs. Before discussing specific I/O routines, the following 
observations m.ust be m.ade about all I/O routines whose addresses axe placed in 
device dispatch tables. 

System I/O routines (such as the generalized I/O routines) are not always called 
in the conventional sense. Instead, each time that a system call requiring opening/ 
closing/reading/or writing is made, control reverts through the dispatch entr}^ 
(DCTDT) of the appropriate device control table, and thence to one of the entries 
in the device's dispatch table. Each device has one of these tables, and each table 
has the following definition: 

Meaning 



Mnemonic 


Displacement 


OF 





OF 


1 


RS 


2 


RL 


3 


RR 


4 


WS 




WL 


6 


WR 


7 


OA 


10 


RO 


11 


EO 


12 


TO 


13 



Open a file for reading /writing by one 

or more users. 

Close a file. 

Read sequential. 

Read a line. 

Read random. 

Write sequential. 

Write a line. 

Write random. 

Open a file for appending. 

Open a file for reading only. 

Exclusive read/write open. 

Transparent (exclusive) open (does 

not alter file access irifo). 

The names of those routines which are required by a device driver are inserted into 
the appropriate displacements of that device's dispatch table. Obviously, an input 
device such as the paper tape reader ($PTR) would not use those displacements 
referring to writing, and would indicate this fact by having a -1 in those displace- 
ments (WS, WL, WR). Then if an attempt were made, for example, to write to 
$PTR, the system call error return would be taken with error code ERICD signaled, 
"illegal command for device. " If instead, for example, a request to close $PTR 
were issued (. SYCT'M, .CLOSE n, where n is the channel upon which $PTR had been 
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GENERALIZED I/O RQUTLXES (Continued) 

opened), then control would be dispatched through DCTDT and thence through dis- 
placement CF of the dispatch table. TTie name of the routine used by $PTR to close 
this device is CLSI; this name is found in displacement CR of $PTR's dispatch table. 

If the routines provided by the I/O modules are not adequate for a user application, 
the user writing the device driver must write his own I/O routines (preferably 
making them core-resident), and insert their names into his driver's dispatch 
table at the appropriate displacements. 

Whenever control is given to a routine whose nam.e is in the dispatch table, 
the system provides the following well-defined input parameters: 

AGO - As passed by user in . SYSTM call 
AGl - As passed by user in . SYSTM call 

AG2 - Address of the UFT corresponding to the channel number 
supplied in the . SYSTM call 

The UFT is a table which, you will recall, is described in Ghapter 1. The UFT is 
defined in PARU, and it is a table which describes each file or device that is 
currently open. 

User-written routines may either do some preprocessing of inputs received at the 
dispatch table and then transfer control to one of the I/O routines, or the user- 
written routine may perform all the processing of these inputs. Preprocessing of 
inputs provided by system calls to OPEN or GLOSE a file/device are not allowed. 

Open (OPNO, OPNI) 

OPNO is used to open output devices, while OPNI is used to open input devices. 
OPNI issues an operator intervention message (if required), while OPNO issues 
the message, provides a form feed, and outputs leader if required. Both routines 
clear a device and initialize its DOT. This implies that the DCT has provided all 
necessary I/O buffer information as well as the seven words of variable storage 
(words 12-16 and 22-23 of the DOT.) 

Input: AC2 - UFT address 

Galling Sequences: 1) Insert OPNO (OPNI) mnemonic into device dispatch 

table at displacement 0, OF. (Input is provided by 
the system. ) 
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Open(OPNO, OPNI) (Continued) 

Calling Sequences: 2) .EXTN OPKO (OPNI), OV LAY 
(Continued) JSR § .OVLY 

OPNO (OPNI) 

error return (never taken) 

normal return 

.OVLY:OVL\Y 

Users may do no preprocessing of inputs to OPNO (0PM). If a user wishes to provide 
a special open routine for a device, the system OPNO (OPNI) routine cannot also be 
called for that device. 

Close (CLSO, CLSI) 

CLSO should be used only to close output devices. It waits until all output has settled, 
clears the column counter, clears the device, initializes the DOT, and provides 
trailer if required. Alternatively, CLSI should be used only to close input devices. 
It merely clears the device and initializes the OCT. 

Input : AC2 - UFT address 

Calling Sequences: 1) Insert either mnemonic CLSO or CLSI into the device 

dispatch table at displacement 1 (OF). (Input is provided 

by system. ) 

2) .EXTN CLSO (CLSI), OVLAY 
JSR § .OVLY 
CLSO (CLSI) 

error return (never taken) 
normal return 

.OVLY: OVLAY 

Users may do no preprocessing of inputs to CLSO (CLSI). If a user wishes to provide 
a special close routine for a device, the system close CLSO (or CLSI) routine may 
not also be called for that device. 

Read Sequential (RDS) 

The device will be read, one byte at a time, until the byte count requested is satisfied. 
The data is not modified in any manner; this command is used for binary transfers. 

Input: AC2 - UFT address 

ACl - byte count for RDS 
AGO - destination byte pointer 
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Read Sequential (RDS) (Continued) 

Calling Sequences: 1) Insert RDS mnemonic into device dispatch table at dis- 
placement 2 (RS). (Input is provided by system.) 

2) .EXTN RDS, OVLAY 
JSR § .OVLY 
RDS 

error return 
normal return 

. OVLY: OVL\Y 

The error return is taken if an end of file or device timeout occurs, at which time 
error code EREOF is returned in AC2 and the partial b}te count is returned at ACL 
If the normal return is taken, the full b}te count read is returned in ACl. 

Read Line (RDL) 

This routine is used to transmit ASCII data and terminate after transmission of a 
carriage return, form feed, or null. All bytes transmitted are masked to seven 
bits. Line feeds and rubouts are unconditionally ignored. 

hiput: AC2 - UFT address 

A CO - destination b}l:e pointer 

Calling Sequence: 1) hisert RDL mnemonic into device dispatch table at displace- 
ment 3 (RL). (Input is pro\'lded by s>^stem. ) 

2) . EXTN RDL, OVLAY 

JSR§ .OVLY 
RDL 

error return 
normal return 



.OVLY: 0VL.4Y 

Ttie read b>te count is returned in ACl, whether the error or normal returns are 
taken. ITie error return is taken and a system error code returned in AC2 for the 
following conditions: 
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Read Line (RDL ) (Continued) 

AC2 Mnemonic Meaniof^ 

6 EREOF End of file or device timeout. 

22 ERLLI Line length exceeded 132 characters without 

a valid terminator. 
2-i ERPAR Parity error Ln the last character transmitted, 

Write Sequential (WRS) 

Data is output in byte form to a device until the byte count has expired. ITie data 
is not altered in any manner. Ttiis mode is therefore the standard mode for 
binar>^ output transfers. 

Input: AC2 - UFT address 

ACl - byte count for WRS 
AGO - source byte pointer 

Calling Sequences: 1) Insert mnemonic WRS into the device dispatch table at dis- 
placement 5 (W'S). (Output is provided by the system.) 

2) .EXTN WRS, OVLAY 

JSRi .OVLY 

WRS 

error return 
normal return 



.OVLY: OVLAY 

The byte count written is returned in ACl. The error return is never taken, 

W'ritea Line (WRL) 

This routine transmits ASCII data to the appropriate device and terminates after 
transmitting either a carriage return or a form feed. Termination also occurs 
upon detection of a null, but the null is not written. Checks are made of the device 
characteristics to determine whether to perform: 

1. Parity on output 

2. Nulls after form feeds 

3. Line feeds after carriage returns 

4. Tab simulation (every^ 8 columns) 

5. Rutouts after tabs 
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Write a Line (WRL) (Continued) 

Input: AC2 - UFT address 

AGO - source byte pointer 

Calling Sequences: 1) Insert WRL mnemonic into de^/ice dispatch table at dis- 
placement 6, WL. (Output is provided by the system. ) 

2) .EXTN WRL, OVL.\Y 

JSRi .OVLY 

WRL 

error return 
normal return 

.OVLY: OVL-\Y 

The write byte count is return in ACl upon exit. The error return is taken after 
132 bytes have been written without detection of a valid terminator, and x\C2 
contains the following error code: 

AC2 Mnemonic Meaning 

22 ERLLI Line limit exceeded. 

TTie RING I/O modules do not provide for random record reading or writing. 

Get Master or Default Directory Name (GMDIR/GDIRS) 

These routines pass the name of the master directory device (GMDIR) or the name 
of the current directory (GDIRS). Hie master directory device is the primary or 
secondary partition which becomes the current directory after a full system initial! ■ 
zation or a bootstrap; this directory also contains the system overlays. Since 
several versions of the operating system may be available for bootstrapping, 
different devices may become the master device. If the name of the current direc- 
tory is requested, only the current directory name, not the colon delimiter and not 
the names of superior directories, is returned. The format of these calls is: 

Input: AGO - Byte pointer to 13 byte user area 

8 
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Get Master or Default Director}^ Name (GMDIR/GDIRS) (Continued) 

Calling Sequences: . EXTN OVL\Y, GMDIR, GDIRS 

JSR § . OVL.\Y 

GMDIR ;GET THE MASTER DIRECTORY NAME 

error return ;ATTEMPT TO OVERWRITE THE SYSTEM 

normal return 



JSR @ .OVL\Y 
GDIRS 

error return 
normal return 



;GET THE CURRENT DIRECTORY NAME 
lATTEMPT TO OVERWRITE THE SYSTEM 



.OVL-\Y:OVLAY 



Two error codes may be returned: 



AC2 

33 

74 



Mnemonic 

ERRD 
ERMPR 



I/O BUFFER MODULE (lOBUF) 



Meaning 

Attempt to overwrite system (unmapped only), 
Address outside address space (mapped only). 



lOBUF is a core -resident module used by nearly all system drivers. One use of 
lOBUF is to execute certain types of I/O instructions; this permits the writing of 
reentrant drivers used by multiple devices (e. g. , a multiple TTY system requiring 
orJy one TTY driver). Another use of lOBUF is to provide common input /output 
character device interrupt processing. lOBUF also provides routines to place a 
bead at the end of a bead string and to remove any bead from the string. Fir^lly, 
lOBUF provides routines which perform common input and output character device 
interrupt servicing. 
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I/O BUFFER MODULE (lOBUF) (Continued) 

The following list summarizes the entries in lOBUF. Before any of these calls 
can be issued, interrupts must be disabled unless they are masked due to the call's 
being issued at interrupt level. 

Entry Use 

CISER Common input interrupt service. 

COSER Common output interrupt service. 

DEQUE Remove any bead from the string. 

ENQUE Add a bead at the end of the string. 

FINP Partial input interrupt service. 

IBUF Input a character to the I/O buffer. 

OBUF Output a character from the I/O buffer. 

PENQU Priority enqueue a bead. 

STOUT? Initiate an output device, then provide interrupt service. 

XDIAC DIAC instruction processor. 

XDOAS DOAS instruction processor. 

XMOC NIOC instruction processor. 

XNIOS NIOS instruction processor. 

XSKPB SKPBZ instruction processor. 

XDLAP DLAP instruction processor. 

XIBUF Priority enqueue a bead and input to buffer. 

Calls to any of the instruction processor entries (XDIAC, XDOAS, etc. ) cause that 
instruction to be built (for the specific device in question), stored in the driver's 
"execute I/O instruction" area (pointed to by DCTEX of the device's DCT), and 
executed. Control is then returned to the caller. Calls to the instruction proces- 
sors are issued solely by the system; specific call t3T3es depend upon the entries 
selected in the device dispatch table or in displacement DCTST of the Device 
Control Table. Upon return from any of these calls, the contents of ACS are un- 
defined. 

Common hiput Device Interrupt Ser\ace (CISER ) 

CISER provides interrupt ser\dce for character input devices. CISER is called 
either by placing the mnemonic CISER in word 2 of the input device's DCT or by 
means of the following calling sequence: 

Input: AC2 - DCT address 

Calling Sequence: . EXTN CISER 

JSR § . CISE 
return to DISKIIS 

.CISE: CISER 
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Common Input Device Interrupt Service (CISER) (Continued) 

Output: If the instruction execution returns a character, this character is 
returned in the device buffer. The input contents of ACl are lost; 
the input contents of AC2 are preserved. 

Comm.on Output Device Interrupt Service (COSER, STOUT ) 

COSER provides interrupt service for character output devices. STOUT initiates 
an output device, starts the device, then branches to COSER. Each routine can be 
called either by placing its mnemonic in word 2 (DCTIS) of the DCT or by means of 
the following calling sequence: 

Input: AC2 - DCT address 

Calling Sequence: . EXTN COSER (STOUT) 

JSRi .COSE 
return to DISMISS 

.COSE: COSER (STOUT) 

Output: If a character is available for output in the device buffer, it is 
output. AC2 is preserved upon exit. 

Add a Bead to the String (ENQUE) 

ENQUE attaches a bead and I/O buffer to the end of the string of beads and buffers. 
This new bead becomes the last bead in the string, and is given a LINK of -1. 
ENQUE is called by m^eans of the following calling sequence: 

Input: ACl - Bead address 

AC2 - DCT address 

Calling Sequence : .EXTN ENQUE 

JSR @ . ENQU 
return 

.ENQ: ENQUE 

Output: The bead and its associated buffer are attached to the end of the 
bead string. If the device is not busy, it is started. AC2 is 
unchanged upon exit. 

Terminate Bead from Head of List (DEQRQ) 

Like FINP, DEQRQ shares common code with CISER. DEQRQ's Of^rations, how- 
ever, are limited to the following: Sets "Request Done" in the bead status word, 
readies a system task if necessary, and determiines if any other beads are enqueued 
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Termmate Bead from Head of List (DEQRQ) (Continued) 

for the device. If other beads are enqueued, updates the bead pointer in DCTQP 
and restarts the device; otherwise clears the device. 

Inpit: AC2 - DCT address ^ 

Calling .EXTN DEQRQ 

Sequence: JSR t .DEQRQ 

normal return 

. DEQRQ :DEQRQ 
Rem.ove a Bead from the Strmg (DEQUE) 

DEQUE remioves a bead from the bead string by setting the bead status word to 
"inactive" and adjusting the adjoining bead links, and by clearing the device 
associated with this string if the device is no longer active. The DEQUE calling 
sequence is: 

Input: ACl - Address of the bead to be removed 

AC2 - DCT address 

Calling .EXTN DEQUE 
Sequence : JSR § . DEQU 
return 

.DEQU: DEQUE 

Output: The bead is inactivated and removed from the string. AC2 is 
unchanged upon exit. 

Partial Input Interrupt Service (FINP) 

FINP performs all functions accomplished by CISER without initially issuing a call 
to XDIAC followed by a restart of the device; FINP is thus an entry in CISER code 
which omits those two functions. FINP presumes that these functions have been 
performed elsewhere (as in the TTY and CDR drivers). 

Input: AC2 - DCT address 

Calling .EXTN FINP 
Sequence: JSR @ FINP 

normal return 

. FINP: FINP 
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Input a Character to the I/O Buffer (IBUF) 

IBUF places an eight -bit character in the currently available buffer slot. All book' 
keeping in the DCT is maintained. 

Input: AGO - character (left byte ignored) 

AC2 - DCT address 

Calling Sequence: . EXTN IBUF 

JSR @ .IBUF 
return - buffer full 
return - buffer not full 

.IBUF: IBUF 

Priority Enqueue a Bead (PENQU) 

PENQU places a bead and its buffer at the head of a bead string. If the device is 
not busy, it is started. 

Input: ACl - Bead address 

AC2 - DCT address 

Calling Sequence: . EXTN PENQU 

JSR i .PENQU 
normal return 

.PENQU: PENQU 

Output: The bead and its associated buffer are attached to the beginning of the 
bead string. If the device is not busy, it is started. AC2 is unchanged 
upon exit. 

Priority Enqueue a Bead and Input to an I/O Buffer (XIBUF) 

XIBUF places a bead and its buffer at the head of a bead queue, and places an 
eight -bit character in the currently available buffer slot. All bookkeeping in the 

device's DCT is maintained. 

Input: AGO - Character 

AC2 - Base address of a dummy DCT. The only portion of 

this DCT which is used by the routine is the bead 
portion of the DCT: displacements DCTQL through 
DCTQS, It is this bead which is placed at the head of 
the device queue. 
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Priority Enqueue a Bead and Input to an I/O Buffer (XIBUF) (Continued) 

Caling Sequence: . EXTN XIBUF 

JSR § .XIBUF 

error return ;BUFFER FULL 

normal return 

.XIBUF: XIBUF 

Output a Character from the I/O Buffer (OBUF ) 

OBUF retrieves an eight -bit character from position PP of the input buffer if one is 
available. All bookkeeping in the DCT is maintained. 

Input: AC2 - DCT address 

Calling Sequence: . EXTN OBUF 

JSR @ . OBUF 
return - buffer empty 
return - buffer not empty 
.OBUF: OBUF 

Output: If the buffer was not empty, a character is returned in ACO, bits 8-15. 
I/O BUFFER KmNAGEMEKT 

As mentioned earlier, there is an I/O buffer for each device in the system, and its 
size may be increased or decreased by the addition or removal or buffer beads. At 
program base level (as opposed to interrupt level), users wishing to fetch a char- 
acter from a buffer issue either an RDL or RDS call which, in turn, calls another 
routine, RCHR. RCHR, RDL, and RDS are disk resident I/O routines in RING I/O. 
The purpose of RCHR is to perform a generalized character fetch using the Device 
Control Table address to read a character from the physical device. Having 
received a character from the buffer, RCHR passes this character to the calling 
read routine. 

Each time RCHR is called, interrupts are disabled and OBUF is called. A character 
is fetched from the buffer, if one is a\'ailable. (OBUF is a core resident routine in 
the lOBUF module, described earlier. ) If a character is not available in the buffer, 
the caller is suspended for a period of time less than or equal to the device timeout 
constant, DCTTO. If a timeout occurs. RTRN is executed; otherwise a loop back to 
the beginning of the RCHR sequence is made. 
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I/O BUFFER MAKAGEMEXT (Concinued) 

Ac interrupt level, input devices input characters to a buffer by means of a call to 
CISER, also described on the preceding page. 

A similar sequence of subroutine calls occurs for output devices. At program 
base level, a call to WRL or WRS results in a call to ACHR which adds a character 
to the I/O buffer. ACHR is a disk resident I/O routine which calls IBUF to add a 
character to the buffer. 

ACHR makes an attempt to place the character in the I/O buffer by means of a 
call to IBUF. IBUF, described earlier, performs functions complementary to those 
of OBUF. If the buffer was not full, then the character is added to the buffer and 
thence is output to the device (spooled, if possible). If the buffer was full, a spool 
for the data is started (if spooling is possible). Othervvise the system task is 
suspended for a period less than or equal to the device timeout constant. 

At the output interrupt level, COSER is used to output a character to the device. 

RDI I — "^ ^ Interrupt 

Service 
Routine 

liNPUT DEVICE 



RDS I *-RCHR^= ►OBUF Service ►CISER 



WRLl^iT- ^ . Interrupt^ 

^VRS \ *" ACHR -^—^ IBUF Service >^ COSER 

^ Routine 

OUTPUT DEVICE 
Retrieve a Character from the I/O Buffer (RCHR) 

Retrieve a character from the buffer by means of a call to OBUF. 

Input: AC2 - OCT address 

CalHng Sequence: . EXTN RCHR OVLAY 

JSR § .OVLY 
RCHR 

timeout return 
normal return 
.OVLY: OVLAY 

Output: AGO -(if successful) character in bits 8-15. 
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Add a Character to the I/O Buffer (ACHR) 

Insert a character in the I/O buffer by means of a call to IBUF. 

Input: AC2 - DCT address 

AGO - character to be inserted 

Calling Sequence: . EXTN ACHR, OVL\Y 
JSR i .OVLY 
ACHR 

error return 
normal return 
.OVLY: OVLAY 

Hie error return is taken in the event of a fatal disk error. 

Declaring the DCT Address 

The last relocatable binary in system library RDOSC. LB is TABLE. TABLE 
contains the interrupt vector, named ITBL, discussed earlier. This vector is 
a linear arra_, of DCT addresses which the system interrupt handler indexes 
by device code. The form of each ITBL entry is: 

.dvdDCT: dvdPCT ; OCTAL DEVICE CODE 

where dvd represents the DGC device mnemonic for each device, and dvdD CT is 
the DCT address of each deface. Each DCT address must be declared as a 
normal external. When adding an entry, the user can select any three -letter 
device mjiemonic not used by a DGC device. 
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Creating a feripheral Device Entry in a Directory 

All peripheral device entries are created (and deleted) as required on every 
imtialxzation of a disk device. All information necessary to accomplish this 
IS m the system overlay SFTAB. Hie information is as follows- 



Word 1 



Byte pointer (overlay relative) to entry name, 
packed left to right. 



^Vord 2: File attributes of the required entry. 

^^^^^ ^' Logical device code. This is the same as the 

physical device code except in cases where 
two or more logical devices share the same 
device code, such as $TTI/$TTR. 

The latter part of the overlay contains the directory entry text strings The 
text string for the paper tape reader, for example, is as follows: 

^^^ ;NAME POINTER 

ATPER+ATWB-ATCHA ^ATTRIBUTES 

^^ ;LOGICAL DEVICE CODE 



.TXTM 1 
PTRP: . TXT /$FrR/ 
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Updating the System Libraries 

The RDOS 04 system libraries (RDOSA/MRDOSA/ARDOSA /RRnnqA .m f 
mes 1-4) are arranged as show in the following ^p^^^^^ ^ '^T? 

m any other libraries, perform an analyze via tfe Hbra'ry file eSo^^^^^ To " 
add a driver, insert it into any of the libraries (^ R nt rf ^"^f^^f }^^^^- ^o 
after SYSTE (BSYSTE/MSYSTFMqYqTpf !f k f ^ Provided it is inserted 

ATABLE). ^^'^' ^/^^SYSTE/ASYSTE) and before TABLE (STABLE /MTABLE/ 

The column labeled "CPU" descrihpc: rh^ t^rr^^ ^-p ^ 

spec. .e.ca..e Mna., ^^U^U SeVL^.^e-^L™ a?.!"::^^ ' 

1 - Unmapped NOVA computer 

' 2 - Mapped NOVA computer 

3 - Unmapped ECLIPSE computer 

4 - Mapped ECLIPSE computer 
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SYSTEM LIBRARY LIST 



LIBRARY A: 



LIBRARY B: 



LIBRARY C: 



Relocacable BLnar%^ Tide 

L\Tri,LMT2. LVIT3 

BL\'m, BL\1T2» BL\1T3 

MPWRFL 

M\PZ/A.\LAPZ 

SCHED/MSCHED/BSCHED/ASCHED 

SYMOD/XfSYMOD/BSY^fOD/ASYMOD 

SYSTE/MSYSTE/BSYSTE/ASYSTE 

OVL.\Y/OVL.\Y/BOVL\Y/BOVL\Y 

OPPRO/MOPPRO/BOPPRO/AOPPRO 

TH'ID 

TTYDR/MTTYDR/TTYDR/MTT^'DR 
DPX!OD/DPMOD/BDPMOD/BDPMOD 
RWBLKAfRWBLK/BRWTJLK/ARWBLK 
BLKIO/B LKIO/BBLKIO/BBLKIO 
F! LIO/M FI LIO/BFI LIO/A FI LIO 

GSUBAIGSUB/BGSLJB/AGSUB 

PLTID 
PLTDR 

CDRID 

CDRDR/CDRDR/BCDRD/BCDRDR 
PTPID 

PTPDR 
PTRID 
PTRDR 
LP132 

LP180 

LP232 

LP280 

LPTID 

LPTDR 

lOBUF/IOBUF/BIOBUF/BIOBUF 



^P^ Primary FunCTion or Contents 



MTADC 

CTAID 

CTADC 

STACKS/STACKS/BSTACKS/BSTACKS 
CELLS 

DKDCB 

DKIDB 

DSKDR/MDSKDR/BDSKDR/ADSKDR 
DSKDC/DSKDC/BDSKDC/BDSKDC 
DSK 1 D/DSK 1 D/BDSK 1 D/BDSK 1 D 
DP7DB through DTODB 
DKPDR/MDKPDR/BDKPDR/ADKPDR 



1 

3 

2.4 

2,4 

1.2.3.4 

1.2.3.4 

1,2,3,4 

1,2.3.4 

1.2,3,4 

1,2,3.4 

1,2.3.4 

1.2.3,4 

1.2.3,4 

1,2.3.4 

1.2,3.4 

1.2.3.4 

1.2.3.4 

1,2.3.4 

1.2.3,4 

1.2.3.4 

1.2.3,4 

1,2.3,4 

1.2.3.4 

i.2.3.4 

1.2.3,4 

1.2,3.4 

1,2,3,4 

1,2.3,4 

1.2,3.4 
1.2,3,4 
1.2,3,4 



M 1 7 DB through MOODB 1,2,3 4 

C17DB through COODB 1 '2*3*4 

MTADR/MK'n'ADR/BMTADR/AMTADR i ' 2 ' 3* 4 



1,2.3,4 
1,2.3,4 
1,2,3,4 

1,2,3,4 
1,2,3,4 
1.2,3,4 
1,2,3.4 
1,2,3,4 
1,2.3,4 
1,2.3,4 
1.2,3,4 
1,2.3.4 
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Full and partial system initializations 

Full and partial system initializations 

Mapped power fail handler 

Mapped system page zero 

System task scheduler 

.SYSTM call processor 

. SYSTM call table and processor 

System overlay handler 

Operator- Foreground /Background commu- 
nications 

Second Telecv^e driver 

Teiet\^pe/video display driver 

Dual processor module 

. RDB/. WRB and . EXEC/. RT.\ handler 

Block I/O Management 

Disk file I/O 

General purpose subroutines and linkage 

Second plotter driver 

Incremental plotter driver 

Second card reader driver 

Card reader driver 

Second high speed punch driver 

High speed punch driver 

Second high speed reader driver 

High speed reader driver 

132 column line printer characteristics word 

for $LPT 

80 column line printer characteristics word 
for $LPT 

132 column line printer characteristics word 
for SLPTl 

80 column line printer characteristics word 

for $LPT1 

Second line printer driver 

Line printer driver 

I/O buffer handlers 

Magnetic tape device control blocks 
Cassette device control blocks 
Magnetic tape/cassette driver 
Second magnetic tape device control table 
Magnetic tape device control table 
Second cassette device control table 
Cassette device control table 

System stacks 

System cells 

Fixed head disk DCB, first controller 

Fixed head disk DCB, second controller 

Fixed head disk driver 

First fixed head disk device control table 

Second fixed head disk device control cable 

Moving head disk DCBs for units 7 through 

Moving head disk driver 
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SYSTEM LIBRARY LIST (Continued) 



Relocatable Binary Title 

LIBRARY C: DKPDC, DKPDC, BDKPDC, BDKPDC 

DKPID, DKPID, BDKPID, BDKPID 
QTYDR, MQTYDR, BQTYDR, AQTYDR 
MCTID, MMCTID, MCTID, MMCTID 
MCTDC, MMCTDC, MCTDC, MMCTDC 
MCADR, MMCADR, BMCADR, AMCADR 
P31DB through POODB 
PWRFL 
BPWRFL 

INTO, MINTD, BINTD, AIKTD 
PANIC 

TABLE, MTABLE, BTABLE, ATABLE 



CPU Primary Function or Contents 



.2,3,4 
2,3,4 
2,3,4 
2.3,4 
2,3,4 
2,3,4 
2.3,4 



2,3,4 
2,3,4 
2.3,4 



First moving head disk device control table 

Second moving head disk device control table 

Asynchronous multiplexer driver 

Second MCA dewce control table 

First MCA device control table 

MCA driver 

Partition /subdirector>' DCBs 31 through 

Unmapped NOVA power fail handler 

Unmapped ECLIPSE power fail handler 

Interrupt determinater 

System PANIC handler 

Tables section 
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Updating the System Libmries (Continued) 

For more information about the contents of the RDOS 04 libraries, perform an 

analyze. 

Creating a System Queue Entr\^ 

A system queue must be created for the device within the device driver. The 
structure of this entry is as follows: 

dvdQ: . ENT dvd Q 

•BLK 2 ;USEDTO POLNT TO DCT AND UFT 

iOOOOO ; SYSTEM STACK IS REQUIRED 

^DCT ;DCT ASSOCUTED WITH QUEUE 

. BLK SQL.N-. -KivdQ ;SYSTEM STORAGE AREA 

The address of this queue entry must be defined in the system queue table (SQ) in the 
TABLE mode. 

An example of this queue entry for the paper tape reader is as follows: 

FTRQ: .BLK 2 

100000 

PTRDCT 

.BLK SQLN-.+FTRQ 

System Generation 

Invoke the SYSGEN save file and answer all queries. Determine the additional 
space necessary to load the new user driver plus any additional words added to 
the system. Before creating the new operating system save file, the value contained 
m the file named NREL should be adjusted down by the additional amount of space 
required by the new device driver. 

To insure that the driver wiU get loaded from the library at system generation 
time, a small program should be written and loaded at this time ahead of the 
RDOSA. LB (MRDOSA. LB) library. ITie program could take the foHowing form: 

.EXTN dvdOC 
. END 

and the relocatable binary called DLMMY. RB. 
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System Generation (Continued) 

File SYSGEN. CM must be modified so that DUMMY appears as an entry after 

iNRELi. ^ 

Invoke SYSGEN. CM to build the new RDOS system 

PRACTICAL HINTS FOR SYSTEM DEVICE DRIVER IMPLEMENTATION 

This section is devoted to a line-by-line examination of an actual RDOS driver, 
the high speed paper tape reader. 

Elements Required in User-Written I/O Routines 

User device drivers may perform I/O in three ways: 

1. By using system routines, placing the routine names in the user 
device dispatch table. 

2. By appending some pre-processing instructions to an existing 
system routine. 

3. By substituting system I/O routines with user written routines, and 
either placing these routines in-line or by placing the routine names 
in the dispatch table. 

The first case, placing a system I/O routine name in the de^dce dispatch table is 

the easiest to imiplement. ' 

In the second case, where the user wishes to do some pre-processing of input para- 
meters,- then transfer control to a system routine, the foUowing steps must be 
followed. The steps in this example illustrate the case where RDL is the system 
call which wiU have instructions appended to it by the user: 

1. Perform a SAVE tefore calling RDL. 

2. Ensure that RDL is passed its requisite parameters. These are the 
UFT addresses in AC2 and the destination hne pointer in AGO. Use 
the RDL calling sequence defined earlier. 

3. Perform an RTRN upon return from the caU to RDL. 

In the last case, a user wishes to write an I/O routine which wiU he used instead of 
a system routme (f^rhaps placing this routine in his driver module). 



except upon opening or closing a device. 
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Elements Required in User-Written I/O Routines (Continued) 

The ioJloivrng example sketches the essential elements of such a routine (leavincr 
blank the I/O code sequence proper) : ^ 





.ENT 


RDLl 


RDLl: 


STAi' 
RSAVE 


3,CSP 




LDA 


0,OAC0,3 




MOV# 


2,2, SNR 




JMP 


TIMEOUT 




ISZ 


ORTN, 3 




RTRN 




TLMEOUT: 


LDA 


2, ERROR 




STA 


2,OAC2 




RTRN 




ERROR: 


EREOF 





iSAVE CALLER'S AC'S 
; FETCH INPUT ACO 

;TEST FOR ENT3 OF FILE ERROR 



;G0 TO NORMAL RETURN 

;GET ERROR CODE 

jRETURN ERROR CODE IN AC2 



Examination of a System Device Driver 

This section is devoted to a line -by-line examination of an actual RDOS driver, the 
high-speed paper tape reader driver (PTRDR). 

Following are the first 11 lines of the RDOS paper tape reader driver: 



4 
•€ib 
£•5 

«o 
U 



.riTLfc PTRuHM ; PAPtR TAPE HEAHtR DRIvER 

.LNT PTHnc,PTkO,PTRUT,PTRtX 

.tXlM yriJOS IfcXtCUTt 1/0 INSTftS 

.tKTN Cl$t^ IJNrE^tRuPT sERVICt 
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Examination of a System Device Driver (Continued) 

The entries PTRDC and PTRQ on line 6 define the PTR Device Control Table address 
and the system queue entry respectively. PTRDT and PTREX define the dispatch 
table address and the execute - I/O instruction routine respectively. PTRDT and 
PTREX are entered so that they can be referenced by PTR ID, the second paper 

tape reader driver. 



1^ 

la L' ./,.-.' I /, .>, .--. :■/ .,, :/. p r K J C T S :4 



FAPfcR liPh K^Ai'f-.K Hj^vict CriNTftOL TA(5Lt 



\; •-:'-:■:■''''/' CIS.. ;iNT iF^iic '^ 

^r :Tz. :::■;::: ;iz^ ^^^^^^^ i^ r^sT.ucTIPN 

?<• V,,-.t 1..', ... i,..;i Pi.'.7.? ' ""^^^^^ ^"^^^T KOuTlNfc ADDRESS 

-^4 ...'.1^ '.,...;..,, J m/i . u r . ' ^^P^'F.n FIHST bYTE ADDRESS 

p^ - . :,,■ ;: :: -^■^■^^ ^ n^tvicF data count 

3; :;. 'i ."■;• j;L H5u.-L.H5nr.r..^3lr-A . ^^.^ status 

•/,"'■..'■'■''' • ■ ** ? t» h A r- 4 L/ 1 ' k P S S 

" ^ nihE nuT In bECOND^ 

Locations through 24 (lines 14-33) comprise the paper tape reader Device Control 
Table (DCT). Word 1 (line 15) defines the interrupt mask. The paper tape reader 
mask word. 1737. prevents all devices with mask bit assignments 6-9 and 11-15 

inclusive from interrupting the reader (thus preventing chatter); see PARS. De\dce 
Interrupt Masks. Word 2 specifies that reader interrupt ser\rice is perform^ by 
CISER, the common interrupt service routine found in the lOBUF mod'ole. Words 4 
and 5 defme the device characteristics and device code; DCIDI indicates that the 
reader requires operator intervention, while DCPCK indicates that the reader is a 
device requiring an even parit}^ check on input, 

PTREX, word 5, is a pointer to the reader I/O execute instruction area. Tnis area 
will be seen later. PTRDT points to the reader dispatch table; this table will be 
seen on page 2 of the reader driver listing. XXIOS, line 21, is an entn- in the 
lOBUF module and will be resolved by the loader. XMOS starts the reader. 
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Examinatio n of a System Device Driver (Continued) 

Words 10 and 11 (lines 22 and 23) define the size of the reader buffer in bvres (100) 
and a pomter to the first b>te in this buffer. Words 12 and 13 (lines 2Tand % are 
allocated for the program b>-te count (PC) and the program b>-te pointer (PP) ;:lpec - 

^MaLl'rt'r=!i '' ^""'^ ^'"'' '"°"'' ^ '''"' ''^^^ '°' '^<^ -=-der buffer, and 
initialize the bead status word to "request done. " Bead mode settings state that the 
task IS to be readied at the completion of each request, and that the data Mfer 1 

Thir^ord is"t;;tiX:d°to ?i.""""^ ''^ ^°"^"^ ^ ^^ ^-^^^^^^^^ ^-^- '-^'^• 

Words 22 and 23 (line 32) are allocated for the first and second temporaries for 

TJZITT ?' '''' "°'' ^ *^ °^^' ™°^^ 24, contains the reader timeout 

constant, 2 seconds. 

Line 35 defines the size of the reader buffer in words, and line 37 allocates the 

buffer space. 

Lines 39 through 41 define the I/O instruction execution area defined for the paper 
tape reader. Location PTREX receives the I/O instruction constructed by lOBUF 
and after executing that instr-uction control is returned to the Interrupt service ' 

ITr I f^^"" '^^ ''''™'^ °^ '^'""^ instructions, lines 40 and 41 (depending upon 
whether that mstruction causes a skip or not). 

t^e^riato '''^ Previously on line 6) defines the system queue entry for the paper 



i^^ i-^ tf. a 5 ' -^ 3 . 



• t' u-A p r ff ri F ; 



34 

3 5 

37 
3y 

4v 
41 

4 5 k'^H'Tcf ♦ ii4^:«^,|^ 

4 b w r- 7 ^ • B '/^ b ;/i •/,. m i 
4e 



i^' '/^- i'.. 6 ' .»-.t^..-ii;i^ P f Rt X J 
¥: ¥■ % : b o ♦ •/= /I 1 4 .4 ^ 



4», 
, O L K 

J.-lP 
Jf.P 



*^,3 
1,3 



^l^^s? 



1 ,:i 1^ vi K 1^) 

PTROC 



; BUFER sot 

I RtStPVE THE BUFFEW SPACE 
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Examinatioii of a System Device Driver (a)ntinued) 

Finally, on page 3 of the driver listing we find the paper tape reader dispatch 
table. PTRDT. This table provides entries to open and close the reader and to 
perform read line and read sequential operations: 



? / ^ ••■■ 1 1 i 

I r k. 1.115 

U ^- t' i i / 

1 >.:i'l?>A 

17 

It* 



p I ^1,^ 



17/7/7 

17 rm 

17,7/7 
17/7/7 
17/7/7 
\ 7 /7 /-/ 
17/777 
il 7 7 77 
17 77 /7 

r /■ . 1 £ i » 

17/7/7 



' I ^ L F I ^l t IMF 

F r k' u T J n H fv I 
CU'^1 

y I s 

-1 
-1 
-1 

-1 

-i 



^-APtK lAPh RtAQhK ulSPATLH TaBlE 



t FTP PtAU bPuuENTlAL 

RtAp nfANDUH 

'-''^nE LINE 
^'KlTE RANPOM 
nPEN FOR APPENDING 
FlAD yKJLY nPEN 

Exclusive open 

PTP Tk&nSPAREnT OPEfv 





PTP 




PTP 




PTP 




PTP 




PfP 




PTP 




PTP 




PTP 



The read random record and all write commands are illegal for the paper tap« 
reader. TOs is indicated by the placement of -1 in these positions of the dispatch 



Following is the cross-referenced s}tii1x>1 listing for the 



^ r '.-' "4 t T k" ~J - 



J-^ 



paper tape reader driver: 



CIStP 
CLSl 
DPNl 
P 1 M H r' 
P T F U C 
PIPDT 
PTFt 5C 
P1PU 
PTFiZ 
Rl-L 
PL'S 
^ M ij S 



M I 
^ k* ./! i U » 

'.''* /j /I » ; 7 f ' 

*■'* »'^ f" C 4 ,: 

•^■:^n i^» 

fl •.' ^» K. i^ / ' 



th 

Ff, 

Eh 
F .N 



2/!,j 
? / il o 

2/?^ 

2/f«o 
2/^b 
?/?Z 
2/{^tf 

2/M5 

2/t^9 



?/!o 
3 / k) D 

2/37 
2/14 
7/2^} 
2/ly 
2/44 
2/3d 
3/^cJ 
3/K7 
2/21 



5/1 4 

2/4D 
3/R5 
2/3y 

2/4/ 

2/3/ 



3 / 1 3 
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Ctt^PTER 3 
USER PROGRAM SERVICED INTERRUPTS 
SERVICIXG USER INTERRUPTS 

Special user devices may be identified either at the time an RDOS system is loaded 
or at run time. This chapter describes the procedure for identif^-ing a user device 
at run time and for creating a user clock driven by the system r^l time clock. 
The considerations given for identifying a user device are common to both single 
and multitask environments; the user clock facility may also be used in both task 
environments. Only ten (decimal) user devices --excluding the user clock --can be 
identified to the system at any moment. 

Upon detection of an interrupt request, the system will be dispatched through the 
device interrupt vector table, . ITBL (see Chapter 1). In this table are pointers to 
Device Control Tables (DCTs) for devices established at system initialization time. 
%¥hether system or user devices. Chapter 1 describes the structure of system DCTs. 

User Device Driver hnplementation at Run Time 

In order to identify a user device to the system at run time, the user must provide 
a three -word DOT as an interface between the system interrupt dispatch routine 
and the user -interrupt servicing routine. The structure and mnemonic assignments 
of this three -word table are as follows: 

Displacement Mnemonic Purpose 

DCTBS Pointer to an 8 -word state save area« 

1 DCTMS Interrupt service mask. 

2 DCTIS Interrupt service routine address. 

DCTBS is a pointer to an eight word state variable save area reserved for com- 
patibility with RTOS. In RDOS, state information is reser^^ed on the interrupt stack. 
DCTIS is a pointer to the routine which services this particular device interrupt . 
DCTMS is the interrupt mask- that the user wants to be ORed with the current 
interrupt mask while in the user interrupt service routme. This mask establishes 
which devices --if any-- will be able to interrupt the currently interrupting device. 

Upon transferring control to the user interrupt service routine, the system will 
ensure that AC3 contains the return address required for exit from the routine, 
and that AC2 contains the address of the DCT upon exit from the routine. 



* See "How to Use the KOVA computers, " Section 2.4. 
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User Device Driver Implementation at Run Time (Continued) 

Exit is accomplished by issuing task call . UIEX; rescheduling may occur as an 
option. 

All multitask environment activity ceases at the moment that a user device 
interrupt is detected. Nonetheless, it is possible for a user to communicate a 
message to a task from a service routine. If the task in question has been 
expecting such a message through issuance of a . REC and is now in the susj^nded 
state, issuance of the message via . KMT will cause that task to be readied 
even though multitask acti\dty is in abeyance. If no task has issued a . REC for 
such a message, . IXMT simply posts the message and takes no further action. 
For more information on communicating to tasks from a user interrupt service 
routine, see Chapter 5 of the RDOS User's Manual, 093-000075-04. 

In addition to . IXMT, certain other task calls can be issued from a user 
interrupt routine or user power fail routine. A complete list of these task calls 
follows: .IXMT, .SMSK, .UIEX and .UPEX. 

All user devices are removed from the system when either a program swap or 
chain occurs. Receipt of a user interrupt on a new program level (which has not 
identified the user device) will cause the system to clear the device's done and 
busy flags and then return to normal program execution. 

Identify a User Interrupt Device (. ID EF) 

In order to introduce to the system those devices (not identified at SYSGEN time) 
whose interrupts the system is to recognize, the system call . IDEF must be 
issued. This places an entry in the interrupt vector table. AGO contains the 
de.^ce code of the new device. ACl contains the address of the new device's 
DCT. In unmapi^d systems, this address must exceed 4008; in mapped systems, 
bit of this address is set if the device is a data channel device. In mapped 
systems with a device using the data channel, AC2 contains the number of IK 
core memory blocks which will be needed by the data channel map. TMs numi>er 
will be one larger than the integer number of 1024io word blocks used for data 
channel core buffers. Tfie format of this command is- 
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Identify a User Interrupt Device (. IDEF) (Continued) 



.SYSTM 
.IDEF 

error return 
normal return 



Possible error messages are: 
AC2 Mnemonic 
36 ERDNM 



45 


ERIBS 


65 


ERDCH 


74 


ERMPR 



Meaning 

Illegal device code (> 778). Device code 

778 is reserved for the power monitor/auto 

restart option. 

Interrupt device code in use. 

Insufficient room in data channel map. 

Address outside address space (mapped 

systems only). 
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Exit from a User Interrupt Routine (. UIE X) 

Upon a user device interrupt. AC3 will contain the return address upon entry to the 
user routine. 

In unmapped systems, before issuing task call . UIEX ACS must be loaded with the 
return address that it contained upon entry to the user routine. In mapped systems 
the contents of ACS are ignored when . UIEX is issued. In both mapped and unmapped 
systems, rescheduling of both the task and program environment (if a foreground/ 
teckground system) will occur upon exit only if ACl contains some non-zero value 
If compatibility with RTOS is to be maintained, AC2 must be restored to the value ' 
it had upon entry to the user interrupt routine. 

The format of this call is: 

ACl - Zero only if rescheduling is to be suppressed. 

ACS - Return address upon entry to routine (unmapped systems 
only). 

. UIEX 

Control returns to the point outside the user routine which was interrupted by 
the user device. No errors are possible from this call. This call can be 
issued m a single task environment. 

Remove User Interrupt Servicing Program (.IRKW ) 

To prevent the system's recognition of user interrupts which have been previously 
demfied by the . IDEF command, the . IRMV command is issued. RequLd -nm 
Removed! '' ""' ''"''" '°'' corresponding to the de.^ce which il to I^ "^ 

The format of this call is: 

^^0 " Device code. 

. SYSTM 
. IRMV 
error return 
normal return 
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Remove User Interrupt Servicing Program (. IR.\W) ( Continued^ 
One possible error message may be given. 
AC2 Mnemonic 

36 ERDNM 



Meaning 



Illegal device code ( >778) or attempt to 
remove a system device (i.e., one 
established at SYSGEN time). 



Set the Data Channel Map (.STMAP) 

User devices employing the data channel in mapped systems must issue a 
system call to set up die data channel map. (A separate map is maintained by 
the mapping hardware for data channel usage. ) This caU sets ud the data channel 
map for the user device and returns in ACl the logical address which should be 
sent to the device. Required inputs to this call are the user device code in AGO, 
and in AGl the starting address of the device buffer in user address space. 



The format of this call is: 

. SYSTM 
.STMAP 
error return 
normal return 

This call is a no-op when issued in unmapped systems. In mapped systems, 

two possible error conditions may occur. 



AC2 

36 
74 



Mnemonic 

ERDNM 
ERMPR 



Meaning 

Device code not previously identified as a data channel device, 
Address outside address space (mapped systems only). 
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Modifying the Current Interrupt Mask (. SMSK) 

Whenever a user interrupt occurs, the interrupt mask is ORed with the mask con- 
tamed in DCTMS of the user DCT to produce the current interrupt mask. iNone- 
theless, it is possible in the service routine to produce a current mask which 
ignores the contents of DCTMS, producing a new mask which is the logical OR of 
the old mask (upon entr^r to the service routine) and a new value. If compatibilit\r 
with RTOS is to be maintained, AC2 must be restored to the value it had upon 
entry to the user interrupt routine. Hiis is done b>^ task call . SMSK, whose format 
is as follows: 



AGO - Kew value to be ORed with old mask. 

. SMSK 
normal return 

There is no error return possible from this call. This call may be issued in a 
single task environment. 



WRITING USER POWER FAIL SER\TCE 

RTOS provides sofovare support for the power fail/automatic restart option 
Upon detecuon of a power loss, the system transfers control to a p"ver fan 
routine which saves the status of accumulators through 3, the FC and Carry. 

When power is restored, if the console key is in the LOCK position, the message 
•*POWER FAIL'* 

is output on the system console and the state variables are restored before 
control resumes operation at the point where it was interrupted If rt/nn , 
key was in the ON position when input power failed, h u^r mu'st set he 

estotd'^Th fc" '" r°'' ^'°""^ ^"' '^-^^^ "^"^ ^ P--^ " e ower is 
restored. This causes the console message to be output and state variables to 
be restored as when the key is in the LOCK position. ' variables to 

The following system devices are given power-up restart service by RDOS: 
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WRITLNG USER POWER FAIL SER\aCE (Continued) 

paper tape readers/punches 

Teletypes 

quad multiplexors 

card readers 

line printers 

disks 

Character devices may lose one or more characters during power up. Each card 
reader may lose up to 80 columns of information on a single card. Line printers 
may lose up to a single Hne of information. Since power up service for disks 
includes a complete re-read or re -write of the current disk block, no disk 
information is lost, although moving head disk units will require 30 to 40 seconds 
before disk operations can continue. Devices requiring operator intervention 
p.ke line printer, card readers, etc. ) must receive such action if power was 
lost for an extended period of time. No power up service is provided for 
magnetic tape or cassette units. 

Power up service for special user devices (or for magnetic tape or cassette units) 
must be provided by the user via the system call . E)EF. The format of this 
call when used to identify user power up ser\ice is as follows: 

ACO - 778 

^^ ' Starting address of user power up service 



routine. 



. SYSTM 

.IDEF 

error return 
normal return 



The error return is never taken. 

Exit from a user power-up service routine in both mapped and unmapped systems 
forces rescheduling and is accomplished by task call . UPEX. The same restrictions 
applying to the use of system and task calls in a user interrupt service routine 

apply to a user power fail routine. 
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Exit from a Power Fail Service Routine (. UPEX) 

Upon entering a user power fail service routine, ACS will contain the address 
required for exit from the routine. To return from the user power fail routine 
in an unmapped environment, ACS must be loaded with this return address and 
task call . UPEX must be issued. In mapped systems, the value input in ACS 
when this call is issued is ignored. 

The format of this call is : 

ACS - Return address upon entry to the routine (unmapped systems 
only). 

.UPEX 

Control returns to the location which was interrupted by a power failure. 
No error return or normal return need be reserved. . UPEX can be issued in 
a single task environment. Note that this call can be issued only in revision OS 
and higher revisions of RDOS. 

USER PROGRAMMED CLOCK 

Two system commands, . DUCLK and . RUCLK, are available to permit the 
definition and removal of a user clock driven by the s}' stem's real time clock 
(RTC). A user clock routine gains control at user -definable intervals. WTien one 
of these mter\'als cx-pires, control goes to a user -specified routine outside the 
current single or multitask environment. No task calls (other than . IXiVrF, . SMSK, 
and . UCEX) may be issued from this interrupt ser\acing routine. 

Define a User Clock (. DUCLK) 

TTiis command permits the definition of a user clock. When the user -defined 
inter\^l expires, the task scheduler and multitask environment --if any-- are placed 
in suspension, and control goes to a user -specified routine. No system or task 
caU (except .UCEX, .SMSK, . IXMT, and .UCEX) may be issued from this user 
routine. Moreover, m NOVA system.s assembly instruction INTEN cannot be 
issued. 
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Define a User Clock (. DUCLK) (Continued) 

The format of this call is: 

'^^^ - Integer number of RTC cycles to elapse 

between each user clock interruption. 

^Cl " Address of user routine to receive control 

when each interval expires. 

. SYSTM 
. DUCLK 
error return 
normal return 

If the error return is taken, the following error code is issued: 

AC2 Mnemonic Meaning 

45 ERIBS A user clock already exists 

Upon a user clock interrupt, AC3 will contain the address of the return upon 
entry to the routine specified in . DUCLK. To return from the user clock routine 
in an unmapped environment, ACS must be loaded with the return address that it 
contained upon entry to the routine and task call . UCEX is issued. In mapped 
systems, the value input in AC3 when this call is issued is ignored. In both mapped 
and unmapped systems, rescheduling of both the task environment and the program 
environment (if a foreground /background system) will occur upon exit only if 
ACl contains some non-zero value. 

The format of this call is: 

ACl - Zero only if rescheduling is to be suppressed, 
ACS - Return address upon entry to routine (unmapped 

systems only). 

. UCEX 

Control returns to the point outside the user routine which was interrupted by the 
user clock. No errors are possible from this call. This caU can be issued in a 
single task environment. 

Remove a User Clock (.RUC LK) 

This system command removes a previously defined user clock from the system. 
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Remove a User Clock (. RUCLK) (Continued) 
The format of this call is : 

. SYSTM 
. RUCLK 
error return 
normal return 

The error return must be reserved, but it is never taken. 

EXAMPLES OF USER SER\TCED INTERRUPTS 

This section illustrates t^'o implementations of user-written interrupt servicing ^ 
programs for devices not incorporated into the system at SYSGEN time. 

Analog to Digital Converter 

The first of the two illustration programs is an analog to digital converter driver, 
found on page 3-12. This driver consists of four subroutines which can be called' 

from a user program, the interrupt servicing subroutine, and a Device Control 
Table. The following is a line by line analysis of the A/D driver. 

Lines 6 - 10 show that the title of the driver is AIDEV. that four entry points exist 
for user access of this driver, and that the driver program is normal relocatable 
(1. e. , that It does not use any page zero locations). Line 15 gives the address of 
the Device Control Table which is defined in lines 17-19. This is an abbreviated 

DCT as discussed earlier. 

The first location in the DCT (line 17) points to an 8-word state save area defined 
on line 30. The second entry in the table is the hardware mask that is set while the 
A/D mterrupt is serviced. 1B8 indicates that all other devices can interrupt the 
A/D converter. The third and final entry m the DCT is the address of the interrupt 
servicing program, ALNTS. AINTS is found on page 4 of the driver listing, and 
will be discussed later. 

Lines 25 - 29 contain additional variables and constants which are required while 
servicing requests to this handler. These %'alues are, in order, the device code 
of the A/D converter, a busy/done status flag, pointers to the address and data 
tables, and the number of pouits to be read for this call. 

ftige 2 of the driver listing illustrates t^vo subroutmes called by the user to attach 
(detach) the A/D converter interrupt ser%-lcing routine to (or from) the RDOS 
dispatch table, ITBL. The first routine, An3EF, clears the ACTIV flag to indicate 
tnat there are no active requests in the handler for data. AIDEF then issues the 
system call .IDEF to define this handler and introduce it to RDOS. An error return 
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x^nalog to Digital Converter (Continued) 

could result L^ the A/D converter device code (2l8) already was assigned to some 
other device. This would happen if a second call to AIDEF were issued without 
any intervening call to AICLR. AICLR removes the A/D routine from the RDOS 
dispatch table. 

a™?n^%t"™^"'""'^ """'"' ^"° ^"'^^°"«'^^«' the analog read random routine 
(AIRDR) and the read request routine (AICHK). The first of these routines. AIRDR 
IS called with AC2 containing the address of a control table. This table is described 
on page 1 ot the listing (lines 34 - 50). This subroutine first checks whether the 
device is currently active on another request by testing the ACTIV flag defined 
earlier (page 1, line 26). If the handler is already active, an error return is made 
to the user If the handler is not active, the ACTIV flag is set and the request is 
initiated. The address of the control table is saved in the active switch and the num- 
ber of points to be read is moved into the handler from the table. Since this routine 
perrorms reads of analog inputs, nvo tables must be provided by the user One 
table must contain the input point addresses to be read, and the other table (of equal 

^o^JaM?! '^'^ '' "'"^ " ''°^' *' "^^°S ^P"' readings. The addresses of these 
two tables IS given m the control table. Before returning control back to the caller 

Is smarted!' ""' '°"' " '"'''"' ''"' " *^ converter, and the convener 

The fourth routine, AICHK, is used to check the status of a call made to the 
converter. There are two returns to the caller: busy and call completed. 
Fage 4 of the driver Hsting contains the interrupt service routine, AINTS This 
routine is entered from the RDOS interrupt dispatch program with AC2 containing 
RnA *"" ^^ converter DCT and ACS containing the address of the 

RDOS interrupt dismissal program. AINTS reads the new converted value, saves 
no n. r "'""^"PP"^'^ ^^'^ ^"ff^^. ^"d then checks to see if there are additional 
points to be read. If there are, it initiates the next conversion. U this was the 
ast point to be read. ALNTS sets the status of the request to indicate that the call 
IS completed and the handler is avaUable for the next user request 
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23 ■■ - - 

24 000Ci4»v500H21 OCOUEI AuCV , n 

25 0i^k505»yt^0^^0 ACTIV: ^ DEVICE COpE UF M/p CO^Vt»^lF< 

26 0000D'0i^00^0 DaPTR: ' ^^^^^^ ^LAG 

27 000«7'0idafe3wP' OVPTR: ' ^^'^^ AOUPtSb AR,-<A/ FOlNlfn 

28 ^10^l0t00^0»55! PTCfwT: ^ ' ^^^^ VALUE AKKAf PU1M|£k 

29 ' OATa CDUMl STUkace 

It '^''''''^^'^ 'iS.vt: .Bt. I. 

32 

34 ; _^i;;Str^ CDMPUL lAHLE LAYOUI 

35 ' " ^"""" ^---- 

37 ^ -^"^^ ^ SlATub FLAG 

3b \ J^ = CALL CuHPLETtn SuCctbSFULL y 

39 "^t = ^tiiiitSl bElfJi, FFuCtSSEi) 

41 ' ""'^^ ^ Ar>DKE5S TaHlE FuPvTr.R 

44 ^ '''°^° ^ DATA ijTOWAf,t lAoLt FOJf.TEK 

45 ' ""''^ ^ ^'L:PDfck UF FulNT^ in Ht ».F,n 

f5 ^ad.i^i^ ,UUS^ 5TAT = 

7 ^'-000^1 .UU5R ATPTkcI 

^a K00B02 .ousR VTFTWS2 

^ -^€.^0^3 ,uL5^ ^WT = J 
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1^ 

01 

02 
i4 

05 
07 
0d 
09 
10 
II 
12 
13 
14 
15 
15 
17 
18 
19 
2^ 

21 

22 

23 

24 

25 

25 

27 

28 

29 

30 

31 

32 

33 

34 



0d2 



^^UCtNSeO HATEkUt- - PHOPEKTf UF LUTa GENERAL COk HUN a T i H:, 
^ If*ITlALIZt TNt A/u oAN'OlEk 



0'^02i'054wia 

«0022' 1024^^ 
00023 '040752 
W0024»^2;47o^ 
a0025'^24753 
00025'00 5vll7 
0M027 «02l'^k-7 
00030'0 0l4^,i^ 
00031 »0014t^l 



00032 »yd540^6 

00033 '020751 
00034 '005H17 

00035 i^21Pll^ 

00036 'k30i400 
00037 '001400 



; CALLING SttJUENCt: 

t JSHAlDtF 

' <b«ROk NtTUkN> 

r «NOkMALRtTuK.N> 



AIOEF 



STA 

SU& 
STA 

LPA 

LOA 
• isYbTM 
.IDtF 
JHP 3 
J^•P 1 3 



UbP 



ACTIV 

OLfJUE 
AUOCT 



I ntViCE LJliE In u.Sc ALKtAQf 



; SET .^UUTImE hiiT HUSY 

I GET DEVICE Lnf;F 

I «tT OCT AuUnEbS 

f ATTACH TO HUGS l^^IEkkuPT 



5 Y 5 T fc -i 



I ERWfjW RkTukN 
; NURMAL kEIUhn 



I DETACH THE INTERRUPT SEnVICImg k-IuTinE 



f CALLING SEfJUENCEl 

' JSk AICLP 

f <NaKMAL PETU«N> 



AIClP; STA 3 USP 

IDA DCODE 

.SYSTH 
,1RHV 

JMP g» 3 
JhP 3 



I Save kETlJWN AuUh^ESS 

I DETACH HRfjH RUOb I.^TEK^UPft SY5TEH 

; NURMAL RETURN 
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01 
02 
03 
04 
05 
0ti 
07 

0a 

09 

10 

11 

12 
13 

14 
15 
15 
17 
18 
19 
2^3 



LICENSED 
AIDEV 



23 
24 

25 
25 
27 

28 

29 

3^ 

31 

32 

33 

34 

35 

35 

37 

3a 

39 

4^ 

41 

42 

^i, 

^A 

45 



k3004l 
00042 

00(d4d 

1^0044 
i^«^045 
00040 

001^47 
00^50 
^0^51 
«50«52 
00053 
00054 
00^55 



'02^745 

' 1 1 M fc^ 4 
'0Sdl4^pJ 
' W 5 7 4 2 
't52l0«3 
'040743 
» t*. 2 I c^ fe? I 
'040737 
' W 2 1 1^ r. 2 
' fc)4i^7»5o 
* I 2 
' 4 1 ij fc5 

♦^22732 

'061121 

' ^ I 4 vM 



HATEHIAL - PKOPENTY UF OaTa GENEr^AL COkPORaTION 



ANALOG READ KANDOM SUBROUTINE 



iNPuT J 

AC2BCaNlRuL TABLE ADOf^ESS 

CALLING SfcUENCE: 
JSR AIRijR 

<ERROk n£1UkN> r HanulE>< ALREADY ACFlVt 
<NOkMAL RETURf«> 



ia0 057»i§21i^0i^ 
^0062 'ki0i4r I 



AIRQRS LPA « ACTIV 

NOV &1 SZR 

JhP t' 3 

STA 2 ACTIV 

LUA NPT 2 

STA w DTCM 

LDA \d k^9^H 

iJTA DaPIR 

IDA VfPTR 

STA « DVPTR 

ADC fl &i 

STA STAT 2 

LDA ^UAPTR 
DO AS k^' AOLV 

JfiP 1 3 



? PICKUP csTATuS PLAG 

? Check it 

; ALREALY fiCTlVt-.EKROR RET'JRn 
I SAVE CUK-TKUt bLUCK ADuRESS 
? GET u PulNTcj TO BE kEAD 

SAVt AS fUTA CDUNf 

GET STARTING ADDRESS uP PuInT auH^F 

SaVE pni^iT ADDRESS TA,3L«- 

C'ET VALUE STOkAuE T«HLfe A.jDkFSS 

SAVt VX\H STyklNG VAtUtS 

SET REQUEST AQTlVt SfATuS 



I GET FIRST PuInT ADDkESS 

; stakt up LUNVtKijiuN- 

; TAKE N-UkMaL RtTURN 



AnALUG input read request Check SUHKDuTlNt 



INPUTl 

AC2SC0NTRDL TABLE AyflKESS 

CALLING SEDUE^CEJ 
JSP AlCr^K 
<BIISY RtTL.Rr,> 
<LOhPLEIED N£lijkf.> 



AICriKI LDA n 51 AT -d 

HDV p. M SZR 

JhP C?- 3 

jHP i 3 



• GtT CALL 5TaTu^^ 

I WlIuEST nfclK[, PKOLEbScil 
t C&LL CO^PLtlEl) 
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1^ 

01 
02 
03 
04 
05 
io 
07 
0d 
09 
10 
U 
12 

14 
15 

16 
17 
18 
19 

20 
21 

*:4 
25 



004 



L 1 C t '^ 5 E D 

Aioev 



NATFNIAL - P.^OHEKTY fiF daTa bEr^tF^L 



CUkPUWa T ID ^ 



; ANALOb TO DIGITAL CONvF^hTck InTc^hupT HuUTI^E 



I I.mpL'T: 



I 

A I N t s : 



00064 '2e2ft<f 1 
^0064 »(d42723 
0aa65Nl47*i.i 
y0066'0^04'.iD 
00k:)6/ » M24^^ 
id0^7« '^42715 
«0d7i 'i^4k^7i4 
00id72 '^3014^^ 



Ma^73».41^7U .AlMORfc 
00074 '^1^713 
00075 '^2271 1 
00070 ' t^6H2l 



AC2 = 0CT AyfiktSS 

AC3 = lK.Tt^KUPT DISHI5.SAL NuUTI.-.t aoOkESS 



OICC ki APiLV 
STA 5? PuVPTh 
DSZ OTC.nT 

Sua -^ 

STA #AClIv 
STA ALTIV 

JMP 3 

ISZ OAPiw 
IbZ DVPIR 

LOA M PUAPTk 
OuAS M ADLV 
JnP 3 



} RLhO ^ALUc--CLEAH CUNvE^TcR OyNc: FLAG 

f SAVt ^^E«LY kban DaTa ^4^11^ 

; OlCkEmEnT data CUUNIEf^ 

» HijRt to COHt 

J Ht-iUtbT CUMPLETt 

I StT USEk UOf^E FLAb 

? SfcT COMVEkTE« •^UN-'SuSy 

? OlSMloS The InTEWKUPT 



t)ATA TAnLE P{)^^jTFK 
; StTuP NEXT COnVERSIUN 
? STAf^T IT 
; DISMISS ThE iNltRnOPT 



LICENSED MATEHIAL 
^005 AIPEV 



- PkOPEkTY OF DATA bENEnAL COkPUWATIQ.. 



ACTIV 


0*^0005 ' 




AOOCT 


000000 » 




AICHK 


0-^0057' 


EN 


AICLR 


0kl^i332 » 


En 


AIDEF 


W t. 2 I 1 


En 


AIMOR 


0^0073 ' 




AINTS 


iM0u63 » 




AIROR 


iki0040 » 


EN 


AISAV 


i ^ ki 1 1 » 




DAPTR 


Bi0«06 f 




DCOOE 


iy00«4 ' 




dtcnt 


0M0MIB 1 




DVPTR 


0e00M7 f 




USDCT 


i0i0ii ' 





1/25 


2/12 


3/i: 


1/15 


2/14 




1/08 


3/44 




l/^'8 


2/29 




i/^e 


2/lw 




4/13 


4/19 




1/19 


4/ltf 




l/0a 


3/15 




1/17 


l/3to 




1/26 


3/22 


3/27 


1/24 


2/13 


2/Z'^ 


i/2b 


3/2fc' 


4/12 


1/27 


3/24 


^/ll 


1/15 


1/17 





3/ Id 



4/15 



4/l0 



4/19 



4/2W 



4/21 
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External Interrupt Recognition 

■nils driver program illustrates an interrupt servicing routine which readies a 
4066 digital interface device driver. 

Page 1 of the listing is almost identical in form to the first page of the A/D driver 
listing ^scussed earlier. The only difference is in the variables and storage 
required by the digital interface. Here, the user must supply the address of a 
commumcations core location. When a call is made to attach the interrupt routine 
address to the RDOS dispatch table (page 2 of the listing), ACO musrconSn" e 
con^munications core address. After attaching the interrupt to die RDOS dispatch 
vector table, the mitialization routine arms the digital interface so dTat is ca^ 
cause an interrupt. ™ 

^\'hen the external interrupt occurs, control is dispatched to the digital interface 
ser.-,cing routine, starting on line 38 of page 2. After the service routi^ae gains 
control, It reads a sixteen bit digital register provided by the interface If the 

TerZr'\r°- "' "'''"''^ '^ ^'"^'^ dismissed. Upon dismissal of the 
mterrupt, the system re-arms the digital interface interrupts. 

A practical example of the use of such a scheme would be the servicing of an 
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I DIGITAL iMtWl-ALF (TY^^H 4df>o} Dhv^lCt Qf-lVt 



01 
02 
03 

04 

ao 

09 
1^ 

11 
12 
U 

14 
15 
lo 
17 

Id 

19 

2'^ 00000 '•^0'^^^1 »dioct: usdct 
21 

22 00baMl »000ya4 f uSOCT: DlSAVt 

23 00002'aa0 4-4'^ loj 

24 00 03'«0k}036' l)I^JTS 
25 

27 ^ ADDITIONAL VAKIA8LE5 ANP oTU^AGE UStO BY HA.>iDLt^ 

2 8 """" " " """ -- 

29 000«4»00^0i0 DISAVtJ .BLK 10 I STATE SAVt ARtA 

3^ 00^14'000042 DCODE: DIO I OtVICf CDDF 

31 00.15.,...., OICOH. . , CyHH5'lCAriON5 AOu.ESS 



•TITL OIDtV 
•E^T OIOEh,DICL^ 
,EXTN ,lx^r 
,^■WtL 
^0^^442 .OUSR i)ID.42 I utVlCE cnnE DtFlNlTin. 

f DEVICE CONTNOL lAbLt LAYOUT 
; . 



! AUDKEbS (Jl- Ulu UCr 

7 iNTtWRiJPT STATE SAVc aRcA 

; I.MTtRKUHT MaS?s 

; iNTtWkUPT HuUTiNt &ij?iKt3S 
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LICENSED 
li0B2 DIDtV 
01 

02 

04 
05 
05 
07 

is 

09 

10 

U 

12 00^16 »054kJl6 

|J 00017t04M776 
0t^02kr. '02ia7?4 
00i^21 'e24757 

2 2 ' i^J t3 J^! 1 7 

0«02v5'w2l0ii^7 
^ 2 4 Hi 1 4 n i^! 
00025 '0 60 142 

00026 »00i40| 



14 
15 
15 
17 

la 

19 

20 
21 
22 
26 

24 
25 
26 
27 

2b 
29 

30 
31 

32 
33 
34 
35 
36 
37 



00027'054^|6 
00 3i4'060?42 
00031 »0207o3 
003<f' 06017 
00033'. 4 21010 
00034'^ 14^0 
00035 t 001 400 



M^ERIAL . Pr^OPENTf OF DaTa b^NEHAL COkPuRaFIOn 
II^ITIALIZE THE DIblTAL INTEkFACfc 



f I.MPUTI AC0sMESSAGt ADU^tSS 



CALLING SfcfJUEK-CEJ 
JSR DIOEF 
<EP«OH kfelUkN> 
<NtikrtAL RtTukN> 



OIOtFl 



STA 

STA 

LD& 
Lf;A 

,SY5TM 
• IDEF 
J^-.P 3 
NI05 DID 
JhP 1 3 



U5P 
DICDM 
DLOUE 
DIDCT 



? "tVICt CnpE CUIU) ALPtAOf I., uSt 



? SAVE C0MHUN1CAT10...S AQDRE'ss 

? AITaCm Tri Runs iNTEk^iiPt SYSTcM 



I AkM The ExTtW^AL 



InTEk^uPT 



! f-l!-!!!!.!"^'^"^^'^^ ^Ehvicing k.-uHne & clEA 



^ Dt»/ICE 



I calling StfJuE'-^Ct : 

' Ji>P OICLR 

'■ <iwOkMal KtTuPh> 

DICLP: STA 3 U6H 
^'luC UIu 
Ll'A DLC'DE 
. & Y S T ^. 
.IPhV 
J M P 3 

J^■P ^1 3 



CLEAR mo DtVlCc 

DETACH HAjxPlEk 

N U P « A i. K 1 1 1 I K N 
•I II 
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IICEN5E0 HMEhIm. - PHOHtkTY uf- UaT4 btNhHAL CU^Hy-fATM. 



3b 
39 
40 
41 
42 
44 
44 
45 
46 
47 

4a 

4 9 
50 
51 
52 
53 
54 
55 
36 
57 
58 
59 



0^035 

^0Sd4kJ 

10(4^41 
00^42 
00043 

00^4D 
00045 
00047 

00050 

00051 

00452 
00053 



? '^ICITAL iNTtWt-ACE ExTfc^^4AL INTFpkuPI niMDt^'*- 
• -----.......... ^-...-,_ ^.«-. ^-.»...- 

I iNPuT; AC2=uCT ADi'WtSij 

AC3 = iNlEKRuPT DI.-iHISbAt AiMjKcSo 



^54b42 niMSJ D|A5 I HU 



12 5-^^3 5 
fcl ,U 4 k^ ^1 

^544i? 
05041*3 
i024^kj 
^42751 
k32075a 
177777 

^004k5l 

3 ^ 4 ,5 2 
*3 2 4 d 2 



Myv 1 1 s.^K 

JHF '/• 3 

STA 3 DlShloS 
SFA 2 SAVt2 

STA PuICO.l 
LDA M DICUH 
.iXhT 

JHP ,"1-1 

LDA 2 SAV&2 
JMP fiulbhiSb 



0000*!}0 SAVt2! t^ 
ld«0 0i5M 0ISHIS5: W 



; WtAi) lo HIT r^tGlSTtK 

»• VALuK ZtWij ? 

; Y c. s - - L- 1 D H I s 5 i ^ r t f* «" 1 J p f 

; NU--SAV(:. Ulb-ilSSAL NfJuTi-^t AH^KcSi 

J 5AVt aC2 AL5 

I ClEAK SIG.mAL ttOiJH^tSS 

• Gr T vSh;^4Al ADu^tss 

r i^AKL i/P u^afk 1A5K 

IKtSlOKcAC2 

I OlSMlbS Tnr. InTcHHUPT 

f TtMPUhAKY STUkAGE ^U^ AC2 

I iNTt^HUPT ftiS'lISSAL AuDkEoS 



,fcNU 



0003 OlDEV 



0004 



LICENSED 
OIOEV 



HATERIAL - PNOPEhTV OF .JaTA GEnEHAL LVIhPqRaIIOn 



DCOOE 
OICLR 
OICOM 
OIDCT 

DIOEF 
DINTS 

DISAV 
DISHI 
SAVE2 
USDCT 
tlXMT 



014 

000027 

000M16 

^00id36 

0^0yi4 

000^53 
0i0y52 

0MiW4o 



EN 



En 



XN 



1730 
1709 
1731 

172^ 
1709 
1/24 

1722 
2748 
2749 

I72i 
1711 



27M 
2729 

2713 
2715 

2712 
2744 

1729 
2755 
275& 
1722 
2/bd 



2731 

2751 



■2752 



275i^ 
275» 
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Licensed Material - Property of Data General Corporation 

' ^'^u^tiprocessor Commimications Adapter 

RDOS revisions 03 and higher extend system support to option 4038. the multi- 
processor communications adapter (MCA). Nonetheless, the MCA can be treated 
as a user-defined device. The following program illustrates such an MCA driver 
and Illustrates the .STMAP call which is required when running data channel devices 
m the user area on a mapped system. 

Page 1 of die listing illustrates the MCA receiver and transmitter DCT's RUSDCT 
and TUSDCT. Hiese DCT's are standard user DCT's; note diat bit zero is set to 
t'^fAr.^'^ '^ required when the devices are identified to the system in subroutine 
MIDEF, smce they are data channel devices used in a mapped system. 

Illt.tft^^'^^^'' """"'^ ^^ initialized before use, and this is done by a user caU to 
MIDEF Illustrated on page 5 of the listing. This routine identifies both die trans- 
mitter and receiver to the system and defines the number of 1024io word blocks 
which will be required for data channel transfers (two blocks each for transmissions 
and receptions). Additionally, this routine converts the logical buffer addresses 
mput to die mitialization call, to physical addresses required for data channel 
transfers in mapped machmes (lines 34-43). That is, whenever a user program sets 
aside a series of logical locations as a data channel buffer, .S-miAP returns the 
actual address assignments made by the mapping unit. Ail addresses in mapped 
user programs are logical, since the user program is unaware of die actual 
locations assigned by die hardware; die actual address assignements, however, 
must be sent to data channel devices. Beyond sending diese addresses to die data 
chaiiiiel devices, die user program need not be concerned widi die actual address 
assignments. 

Since MIDEF identifies die MCA units to die svstem onlv once, MIDEF can be 
mvoked by die user whenever different read/write buffers are to be used. 

Tne read and write subroutines proper are fo'und on listing pages 2 and 3. Each of 
diese routines first checks to see if die device is busy; if so, die error return is 
taicen Odienvise, each routine outputs die word count and logical starting addr-ss 
to its device, and die transmit routine also outputs die receiver number to tfi- 
ti-ansmitter. Hien each routine waits, via a call to .REC, until its associated 
interrupt processor (page 4 of die listmg) readies it via an interrupt message call, 
. IXMT, maicating tiiat die process is complete. The read/write routine d-n 
resets its busy flag and talces die call's normal return. 
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^.... ^c:^ti':^^^^i^'i- - — - - ^:i:,^^f :^^.s--— 





07 



; f-ULllHr^f-CtSSOH CnnPu,\'ICATI0.M5 AuAHTtR CIYPE 4^3d) 



0y 
1^ 
u 
1.^ 
10 

1/ 

lb 

19 v: to h /I i:, 

2 it! i,*. ¥^^ s I 

21 

2 2 V' k^ ^'. «£ 
2 r; k* t: '^/l 
'4 if! [^- ^-^ kI 4 
D 

2d (^- ^ '..-. /> 
2 7 tj^vii^, Q 

2 a k)^¥)'A / 
2b 
6^ 

vJl , 

s32 

3 w I/. 14 u-i ' ^- 1^ ^1 1^ ^ 7 R C iJ E : M L A w 
^4 ^ ^U: 1 1 » '..T M^i ^.V b TCOoe: hLAT 
3 5 w k< t' I 2 ' >.j ^^•J ^J 1 /I M o A v h : 



.ririt .MCADk ; MCA DrtlVErt 

,tNT mCa«u hCawT HliitF 
• tXTN . IXMT,. kEC 

'* DcViCc COnTnOL lAbLt LAYPuT 



i^^.^,2 'fiKDCT: id^ + k-gSDCr 

•/I / ^1 kj 1 :£ ' H J S J C T : H 5 A V t 

^J0d^li^ Ir5l2 

^ ^ fc 1 tr'' 1 ' W I N T S 

vi^^i0l2 'TubuCT : ^•.bAvF 

<■ ^^ i4 vn v^ i n 1 2 

?1 w 1^ 1 tr' 6 ' T 1 N T S 



? Aj(,hE5S Of- f^CA kECFlVt^ OCT 
r AyiiKEiS UF ^:CA 1 R AN5.M i IT t'K U 

; iNTckKUf-T 51A1E Save A.-^cA 

; H A s (^ w K 

,' iNTtHftHHT NuUTInE AlKIrESS 

IivTe^^kupt sjafe Save apea 

I.MTtkKUPT NuUTIr^iE AIjijkESS 



; A.jditionAl vAkIaHlE^ (-[jk .-Ca uPiVci 



oLk 10 



', P t C E I V E H U f- V I C F C U f ) E 

; TKAi\SnIITEK DEViCt CODE 

; STATE SAVc AReiA 
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LlCtNStD MATEhIAL - PkOPtn'TY 

01 

^'''^ I f^CA RtAp iUBWbliliNF 

05 
6 
0/ 
ide 

1» 
! I 

Ik 

14 
ID 



OF UaTa GE.NtHAL COkPuWaTIOn 



Input :- 

ACl^sl^yPO COUNT 
CALLING Stt.<utNCt :- 

J 5 f< M t A K D 

knOhM AL ktTUPN> 



HANPLtR ALPtADY ACTIVE 



Output t- 

ACl 



MCA STATUS ^OkD 



Id k' M r 2 id ' ^U y 4 H i^ M C A H : 

17 /' ^u.. 2 ' I 5 I W v3 4 
Id V. t'. vr" ? 4 ' ^ i4 4 2 2 

1 i* k e r • 2 D ' if 1 W 4 1 5 

2 ^i f. W t. 2 • lii 5 n 4 1 6 
2i kH-u,2/ » •/.b44 1 2 
2 2 t- *^ i/M I') ' y 6 2 Id v< 7 

^ v.- r ^'. vU ' /. 2 4 4 1 4 

2 4 k'^v-'':id * ^ooiy,; 

2 5 1^ ^ e. J J ' »f ' 2 V 4 1 

2o kj'^^i^^ ^ I 7 /777 

2 7 r. k'-r d D ' 1 2 4 M 
25 Mi^s'>s5o'i^4v)4^. 4 
29 yit.t:67 U>ik>4^j2 

3 i^ K ^V: 4 ^ » i^s /. 2 4 1', I 
31 

42 /. C^':i41»itH^-»4,^-^ 

3w fl^-r; 4 2 ' •/. I'H.Hi^i 1 
34 

3d w k' t 4 j » .1 1' •;'^ 4 4 » N D I b L ; 

3 5 ti; i'^ r 4 4 ' ,1 ^^ ^, .^ 1^1 I 
3/ 

3 e y m k- 4 D H-: i4 k ^ ^^ .}^ R A u U N : 
3i^ 

4 to 
41 

4 2 k'^',1^ 4o ' »'3r- 4-^:2 PlNF^^: 

4^ il^L. 4/ • ».^ 1 4r'^ 

44 

4 D k* i-' ,: 5 .4 » /. ►'> ; 



p K T N : 
p a t .' 5 Y 



lUA 
MUV 
JMP 
152 
STA 
STA 

u d 

LUA 
UOAS 



2 phusy 

2 2 5ZP 

K t P T N 
PbUSY 

2 PSlbLi-1 

3 PKTfM 
M mcAk 

1 P A [) u P 
1 ilCAP 



LuA w 

.WFC 

Syrt t> 

STA 

ISZ 

JhP 



^^ o It- L 



14 

Pi P h 1 1 5 Y 




1 

.♦I 

.bL!s 



LUA 
Jr.p 



w u V ti S f 
3 



PICKUP 5TATUS FLAb 

CrttCK TT 

fJtVICt dUoY 

StT PUU [ Ilvr Busy 

PtStT DuNt 5I5G.MAL 

SAVt KtlUPN AUDKESS 

StNU k^OkD CUUnT Tu PF.CElVtR 

PICK UP LUGICAL STARTING ADPPtSS 

StNU alAPTlNG AuOktbS 

WAIT hHH uPtPATlO.v COMPLETE FLAG 



t RhStT PtCkivtN dU5Y Flag 

# T A K r. N U K K A L P c T u k N 



PtCtlvFP Dl.-FFtP LuGlCAL AuDkESS 
AS yfcFl^,EU dY .dTnAP SYSTtM CALL 
nuPlNG DFVICE iNlTlALiZATlOr, . 

OtVlCt ALREADY BHiY 

P K C t o S I K- G 6 P P c V I n u S CALL 



•'*• ^ 7 P J V d vS Y I 1 k S I r- 



SiHliL I Af^Flilj5 rtFAn5 yR NHlTtS 



^^fJT ALLOi^ 



3-22 






LlCtNbEu 



MATfchlAL - PHhr^fnTi yF Data GFnE^Ai. CPhPuW a T i n.-^ 



HCA^T 



fc2 

'^S 
00 

■?1/ 
H5 

^ 

It 

u 

12 

U 

14 
ID 
ID 

1 / iJ f/; r] 5 1 

lb 0t^^5;r! 

<J t> y l/l ^? 5 4 

21 r4l ,d 5 D 

2 k (ci ^^ e- 5 b 

2 J ^» /1 5 / 
2 4 ki s^i fe. 6 
2d ^,^-^hi 

2 / ki W i^ b 

2 ?5 k:i r o 4 
25 fe-; ^ w b D 

3 If"! to t> o 

31 &< 6 7 

32 ^) t^ w 7 k4 
3 .5 i,^> ^ ^j 7 1 
3 4 ri I/, rt 7 2 
3d 

3 kJ i^ w 7 3 
37 ^ vi 7 4 
3& 
39 n Id ^ 7 D 

4 m ^} H ^ 7 o 
41 

42 Wfr^K77 f k)000/,0 TAOUR: 

4o 

44 

45 

4& 

47 

18 

49 



MCA w K J 1 ^: S u d K 1 1 u T 1 "4 c 



1 r^ p u T : - 

A C V^ = .^ l.i k 'J L n u N I 
ACl=^tCclwhK i'JunhcR 

c A t L I N c, s t fHi 6 . J t: L : - 

J 5 R H C A ^ T 

< t W h n K »*• C 1 L' .t N > 

<nUHMal »^hluWN> 



1^1 alls H-3 (1-17(6)) 



OuTput:- 

AClsHQA STA1LI5 



e 3 /. 4 2 3 
1 '5 1 ^ ^ 4 
^J it" tj 7 7 3 
•1 1 (4 4 c k» 
^44423 
y b to 4 i; '4 
U.5 4 4 14 
i^) 6 2 w 6 
i()244l6 
w 6 D 'd ^^ 6 
vi 3 ^ 4 1 5 
^-'731^6 
kJ 2 v^< 4 1 ^ 
^,' c' if) 3 4 ♦ 
1 1" 2 4 kj ^4 
H 4 i/j 4 'yi 4 
t5 1 V1 4 2 
k) '4 2 4 ^ 1 

€' '/I V^> '(^ ^ 

•S lA yj 'tS yl I 



LUA 
^^UV 
JflP 

152 
STA 

STA 
ST A 

UUtJ 
LuA 
UOA 

LUA 
UUC5 



2 TbHbY 
2 2 SZW 

TtKTN 
TnlJ.SY 

1 P t C U V 
T ^5 1 b L ■»• 1 

TrtT,\ 
HCAT 

T ADuW 
HCAl 

R fc C D V 
M C A T 



2 



LUA t^ 

SI A 
Ibl 

JMP 



TSIbL 




If! T s IJ S Y 

T k T .^^ 



•^owp Fur tkai\Sii I r Tcr 



PiCMtP STATUS F|_Ab 

CritC's IT 

ALRtAUY AuTiVt - tRRON ktTURN 

iNHiCATt UhvlLe 15 rilJSY 

SAVt KFLtlVtR Nu^dEk 

RtStT THANSnllTcR OUNi; SIbNAL 

SAVt rtF IUkN AuDkE5S 

PICKUP LObJLAL iTARllNb Aunness 



I k-AlT FOH uPcRATiON CO.^PLETe 

t RtStT TRANShlTTtR BUSY FLAG 
; TAXt NflHHAL RtTuRN TO USER 



T K T .M I 
T d U S Y 



^j H 7 6 » T S I b L : 

W f1 fe? K ^ 1 




1 

• oLK 



a0^046»TeRTN= RtRTN 



^.P>l^S¥]^-^^'ti9l-^jVi R£Cl)VI 0«j 



I THANSHITTER BUFFEk LOGICAL AODRtSS 
; AS uEFIfjeu bY .STMAP SYSTEM CALL 

t ouRiNb DEVICE Initialization . 

,• TRANSMITTER BUSY ERROR hEIURN 



! RtCtlVtw UEvlCE NyHBER 
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10 
01 

^6 
04 
05 

0b 
^7 
v)b 
iAy 

Iw 
11 
12 

14 

Id 

10 

1/ 

16 
ly 

2^, 
21 

2kf 



to»^4 



LlCcNSEO 
MCAUW 



MATEklAL - PkOPE^TY uF OATA GEnEKAL COkPuRATlON 
I HCA PtCtlVER iNTfrK^^uPT PROCtSiOH 



ii t^ UU ' I'* 6 o 5 w 7 
y 1 1'^ 2 ' ^'' 2 to 7 4 1 
i'-^1^0»1777;7 

I;, y^ 1 y 4 » t'. n 4 ^ ei 
1^ W 1 Vi D ' ^] |4 fci 4 y 5 



PINTS.' 



m c c 1 H c A R 

LUA n RSIbL 
• IXMT 

JMP DlSrtloS 
JMP OlSrtliiS 



? CLEAR RtCtlVER/KEAO STATUS 
'» GET SIGNAL ADuRtSS 



', MCA TRANSHlTTtR INTERRUPT PROCESSOR 



t * 1 -^ o 

b !^. 1 v^ / 

^, / 1 1 1^ 

»;■ •'•^ 11 1 

»" I'M 1 5 



k b D h ^1 6 T I N r s : 

•/'24i..7o6 
« i?; 1 1^ 3 ' 

S/l t/'l ^ 4 1^ 1 

e- 3^.4 ^,2 DISMISS 

«-'b^^2/'2 



Dice 1 M C A T 
LUA n TSIbL 

• U M T 

JMP .4-1 

lCa 2 J scot 

^; I r J c HAP 



iil^ 1 1 4 ' /. r M ^. 3 U S C u E I (^. vi 



; Clear TKANsr.iTTcR/Rt ad status 

I GET SIGNAL ADDRESS 



? GtT DI ShIbS CODt 

? iKlbCtR Tnt f^KPy 

? CUDE FCk UlbHlSSlNG TnE iNTtRrtUPT 

»• Under a nuva 64^ svsteh 
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S ¥j V- b 
Ac '' 

■AO 

0/ 
•4c 

11 

12 

lo 

14 
ID 
15 
17 

Id 
U' 
2u 
21 
2^: 
2a 
2^ 



■*•' C A u R 



•t'' k' i 1 ' y 5 -^4 4 J 7 

kJ S^ 1 I O ' '3 4 k-i 7 2 4 
0^117 '^^44705 
k'' fc^ 1 2 1^ UU k' 4 D 

«' '^ 1 2 1 ' ^ i^ /; 4 1 4 

t^ M 1 2 2 U- 2 fc b c 6 

•*i»12J'^2«Go5 

«0^i24'^3,i4o2 

^k)l2b ''.105^117 

0i^l2o»^^}2lMl^7 

■? tf 1^ 1 2 7 ' ^ f^ ii 4 ^ 5 

«i ^Hn v5 y Uj 2 w 6 1 

2 7 ^. '.1 1 3 I ' 'ij 2 *i 6 D 

2b b^^ld2 'i^^0fc117 

2 ^ M 1 v^ ' -4 2 1 7 
3 ^/ k'frU 3 4 » wj t4 2 4 2 
31 fe'idlv5b'd5 44k^0 

3 2 ^? n 1 3 » 1.4 2 e^ 6 5 2 
3o ^Wi3/ »^.247^3 
3 4 yiyil^<A^ /j'-Ao\Ai7 

3 b if' frn 4 i I ti 2 1 ^ b 
3o fe..i^l42'stf 2412 
37 H0i4v5'4447d2 
3d w m 4 4 » ^) 2 1» 6 4 5 
35 k'f^l4D'tf247if7 
4to 0Ml4o»e0 50i7 
4i 1^^147 »^2lHo5 

4 2 B fr'i 1 b s^ ' W 2 4 (^ 4 

43 MM 151 ''^44726 

44 0^ib2'tflk}4y2 
4b w^l53'cl 02401 
46 

fei 1 b 4 » ^ ^. 



rtATEnUL - PwnpFKTY U^ DATA Ctr.EKAt L^KPuk-ArI^^. 



iNlTlALl/ti Tut ^'Cii HA;v,OLt'K 



A 1 1 s 5 T A K T I N tj 



LUfit Aur-JHESS Or HECclVtQ HuFl-ER 
Li^Ht AuDKtbS 01- 1 ftA^J5HXT FER oUFFh^ 



HlOtF: 



HACTV : 



4/ 

46 
45 



MPlbb' 177777 
k) M 1 5 b » ^1 ^ ^ '^ ^1 2 



HCAfVl 
Vit 



«.c t 


« U K K t 1 1.1 rs N > 


<.\CjkHAL f^'tTyR^O 


SFA 


3 H I k T N 


STA 


^5 RdlJSY 


STA 


1 TdiiSY 


IbZ 


HCATV 


JMP 


M A C F V 


Li;A 


^ P C U L' E 


LOA 


1 M K 1 ) C T 


LUA 


2 C2 


, b Y T M 


.IDtF 


J.iF 


« M I K T N 


LUA 


w T C U U E 


LUA 


1 H T u C T 


.bY.STH 


• lOtF 


J.-iP 


PHI Hi H 


STA 


3 MCA! V 


LtJA 


^ PCOUE 


LOA 


1 PdUSY 


. 5 Y S T H 


, 5 T fi A P 


JMP 


f M I N T N 


STA 


1 R A [1 U R 


LUA 


» TCOUE 


LUA 


1 TolJSY 


. 5 Y S T H 


,5THAP 


JnP 


P fi I N T K' 


STA 


1 TaDuw 


ISZ 


H I p T ^•• 


JHP 


P h I w T N 



mIPTn: 



-1 
2 

,tND 



SAVE kETUPN AuDPEbS 

SAVc uStR HuFFEP ADuPtSSES 

ntVlCt ALkEADY l.^TRODuCED Ty bVbTEH? 
YtS, JiJbT C-tT LuGICal AUUkESSES 
PtCfclvEP UP VICE CuOE 

peceivek uevice cuntpul tablf 

NuHbEH UF U BLUC^S 
DtFlht DEVICE ru bYSTtH 

TAKt EPkOk PETUPN 
ThAns.^UTEP DtVlCt CODE 
THANSnlTTtP DEVICE COnTPOL I AHI E 
OEFlNt DEVICE TU 5YSTEH 



TAKc EPpOP PETUpN 
StT ACTIVt ELAG 
GET DEVICE CODE 
USEp dUFFeP ApUPESS 
CitT LOGICAL AUDPESS 



OF BUFFER 



TAKt tPPO;^ pEIUPN 
SAVt LOGICAL AOUPtSb 
DtVICt CODE 

GET BuFPEP ADDRcSS 
GET LUGICAL AuDPESS OF 



USER euFFEP 



» TARE EPPOn pETUPN 

; SAVE LOblCAC AOURtSS OF TPANSHITTER B 

I NUPMAL PEfllPN 

I RETURN ADDRESS 

• NCA DEVICE ACTIVE FLAG 

I NUMoEP OF 1W24 wOrtO BLOCKS FOP MCA 
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0000 HCAOrt 



LlCtNSED MATERIAL - PROPERTY OF DATA GEnEkAL COHPURATION 



C2 

01 SHI 

OSCUE 

MACTV 

HCAkD 

MCATV 

HCAwT 

MiOtF 

MIRTN 

HkDCT 

M 5 A V H 

MTOCT 

RaDl^r 

RbUSY 

PL OPE 

RuVdS 

PtCUV 

RtRlN 

PINTS 

RkTi^ 

RSIbL 

ftUSDC 

TfiOUR 

T D U b Y 

TLOl/E 

TtRTN 

TINTS 

TkTN 

ToIbL 

TUSDC 

.iXhT 

.KtC 



MMi^l 1 'd 
M0fr11 14 

^. 2 ii 
i^ kl *^ i 5 5 
M i^ /J 5 i 
^0^1 ID 
i4 S(i fei 1 5 ^ 

W k'^ rt k1 tt 

CI i^ M 1-1 1 2 

fe^ W f'. »^. 1 

y ti ^' ^ 4 D 
la w H 4 2 

ti fe^. » 1 k!' 
M ^ ^ 5 ^4 

i'^ K 1 i^ t: 

Pi^10^ 4o 

^^ w 01^1 

« kl H i-) 4 1 
^1 H D 4 v5 
V^ l^ 1-1 •• i^ 2 
i/^ <l k-,' if; 7 7 

e) rf H ^1 7 4 

^5 ^ '-' e. 1 1 

^' K^ t" 4 D 

i^ « ^ ' H^ o 

C^' t4 I'l t;3 7 O 

Mi'^<^-."7 5 
i^ i^ D 
^^ ,1 ?". U t'. 

i^ y t' t^' D b 



EN 

En 
En 






5/22 
4/P8 
4/16 

5/iy 

l/li4 

1/10 
1/lii 
>*^/lb 
5/47 
1/19 
1/22 
l/2w 
2/2^ 

2/lD 

1/33 
2/42 
3/21 
2/ia 
1/24 
2/21 
2/2*^ 

1/iy 

3/25 
3/17 
1/34 
6/ly 
J/2a 
3/23 
3/22 
l/2d 
1/12 
1/12 



5/61 

4/^^ 
4/21 
5/31 
2/ 1ft 
5/31 
3/17 
5/15 
5/2D 

5/21 
1/2d 
5/27 
2/3d 
2/ly 
5/20 

2/4D 

3/2/ 
2/42 
4/1^5 
2/?^ 
2/2d 
1/22 
3/4;^ 

3/2^ 

5/2b 
3/4n 
4/1 4 
3/3 j» 
3/2:^ 
J /2t> 
4/tv 

2/2u 



4/ia 



5/5w 



5/3k^i 



1/3D 

5/37 
2/2a 
5/32 

3/49 
3/4o 

2/3/. 
2/3d 

5/4o 
3/32 
5/3e 



3/34 
3/3a^ 

4/10 

3/3v.. 



5/3b 



5/42 



5/44 



5/45 



2/33 



5/15 



5/33 



2/32 



3/37 



3/3^ 
4/lD 



5/17 



5/3y 
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AGO 2-4f* 

ACl 2-4f 

AC2 2-4f 

ACHR 2 -3 If 

AGSUB 2-5, 2-7ff 

analog to digital converter 3-10£f 

beads 2-16ff 
BGSUB 2-5, 2-7ff 



cassette 2-1 




$CDR/$CDR1 1-3,2- 


-l,2-7,2-18f,3-7 


CLEAR 


2-9,2-12 




CLSI 2 


!-21 




CLSO 


2-21 




CMPWD 


2-9,2-llff 




COSER 


2-27,2-31 




CSP 2- 


■5ff 




DC 2-16ff 




DCHMP 


1-11 




DCHNM 


1-11 




DCCRQ 


1-10 




DCDST 


1-10 




DCNBK 


1-10 




DCNBl 


1-10 




DCSTR 


1-10 




DCi'BC 


1-8 




DCi'BD 


1-9 




DCi'BP 


1-8 




DCTBS 


1-7,3-1 




DCTCC 


1-9 




DCTCD 


1-8 




DCTCH 


1-7 




DCTDC 


1-9 




DCl'DP 


1-9 




DCTDT 


1-8, 2-19f 




DCTEX 


1-8 




DCTIN 


1-10 




DCTIS 


1-7,3-1 




DCTLC ' 


1-9 




DCTLK 


1-9 





LNDEX 

DCTMN 1-10 
DCTMS 1-7,3-1 
DCTNH 1-10 
DCTNS 1-10 
DCTOF 1-9 
DCTON 1-9 
DCTOP 1-9 
DCTPC 1-8 
DCTPP 1-9 
DCTPR 1-9 
DCTQL 1-9 
DCTQP 1-9,2-17 
DCTQS 1-9 
DCTRD 1-10 
DCTRL 1-10 
DCTRN 1-10 
DCTRS 1-10 
DCTSL 1-9 
DCTST 1-8 
DCTSZ 1-10 
DCTTO 1-9,2-30 
DCTTl 1-9 
DCTT2 1-9 
DCTT3 1-9 
DEQRQ 2-27f 
DEQUE 2-28 
device codes 2 -If 

Device Control Table (DCT) l-5f,2-3, 
2-32,3-15,3-17,3-20f 
digital interface driver (4066) 3-16ff 
disk l-3f,l-10f,2-l,3-7 
DISMS 1-6 
dispatch table 2-20ff 
DIVD 2-9,2-13 
DIVI 2-9,2-13 
DP 2-16ff 
$DPO/$DPI 1-3,2-1 
.DUCLK 3-8f 

ENQUE 2-18,2-27 



*Note: r means ' and the following page'; 'ff means ' and the following pages. ' 
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frame pointer 2-6 
frame sizes 1-10 

GDIRS 2-24f 
GMDIR 2-24f 
GSUB 2-5, 2-7ff 

IBUF 2-l6ff. 2-29, 2-31 
. IDEF 2-1, 3-2f, 3-7, 3-10, 3-13, 3-18, 

3-25 
INTO 1-4,1-6 
INTS 1-6 

lOBUF 2-25ff, 2-30 
IPB 1 -3 

.IRMV 3-4,3-13,3-18 
ITBL l-5ff, 3-1 
. IXNfT 3-2, 3-16f, 3-19f, 3-24 

LDBT 2-9 
LDCHR 2-9 
SLPT/SLPTl 2-1,3-7 

magnetic tape 2 -2 
mask 1-3,1-6 

MBLK 2-9 
KIBMVW 2-9, 2-14f 
!vlCA l-3,2-lf,3-20ff 
MCLR 2-9,2-12,2-15 
MGSUB 2-5,2-7ff 
MFMVB 2-9,2-13! 
MFMVW 2-9.2-14f 
MLDUr 2-9,2-14 
MP\' 2-9 
MF\^AD 2-9 
MSTBT 2-9.2-11,2-14 
KfTKWB 2-9,2-13f 
KCTMVW 2-9,2-14f 
MVmr 2-9,2-11 
MVMFW 2-7 
MVWD 2-7,2-9,2-131 
MXTMP 2-4f 

NMAX 1-11 



OACn 2-5ff,2-39 
OBUF 2-16ff,2-30 
OPNI 2-20 
OPNO 2-20 
ORTN 2-5ff 
OSP 2-6f 
OVRTN 2-6f 

PARS 2-5,2-10 

PARU 1-11,2-30 

PC 2-16ff 

PENQU 2-29 

$PLT/$PLT1 l-3f,2-2 

power fail service 3-6ff 

PP 2-16ff 

$PTP/$PTP1 1-3,2-2,3-7 

$PTR/$PTR1 1-3,2-2, 2-19,2-39ff, 3-7 

QTY 1-3,2-2,3-7 

quad multiplexer (see QTY) 

RCHR 2-30ff 

RDL 2-20,2-30f,2-38 

RDS 2-21f,2-30f 

.REG 3-20,3-22f 

2-8ff 

2-7,2-15ff 

2-7,2-15ff 
RING3 2-15ff 
ROX 2-9f,2-12 
RSAVE 2-6,2-9ff 
RSTFL 2-9.2-13 
RTC 2-2 
RTLOC 2-4f 
RTN 2-5f 

RTRN 2-6,2-11,2-30,2-38! 
.RUCLK 3-9! 

SAV 2-5 
SAVE 2-6.2-38 
SETFL 2-9,2-13 
SFTAB 2-33 
.SMSK 3-2,3-6 
SP 2-4 
SRTN 2-5f,2-9f 



RETN 
RINGl 
RING2 
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SRTRN 2-6,2-11 
stack frames 2-4 
STBT 2-9. 2-11 
STCHR 2-9,2-11 
.STMAP 3-5.3-20.3-25 
STOUT 2 -27 
SYS.DR 2-2f 

system generation (SYSGEK) 2-3, 2-37f 
system library 2-3,2-35ff 
system queue 2-3,2-37 
system stacks 2-3ff 

TeleD/pe or console i-3f, 2-2,2-18 
TMP 2-4,2-6f 

. UCEX 3-9f 
UFCAl 1-12 
UFD 1-11 
UFEAl 1-12 
UFFAl 1-12 
UFLAN 1-12 
UFLAl 1-12 
UFNAl 1-12 
UFTAC 1-12 
UFTAD 1 -12 
UFTAT 1-12 
UFTBC 1-12 
UFTBK 1-12 
UFTCA 1-12 
UFTCB 1-12 
UFTDC 1-12 
UFTDL 1-12 
UFTDR 1-12 
UFTEA 1-12 
UFTEX 1-12 
UFTFA 1-12 , 
UFTFN 1-12 
UFTHM 1-12 
UFTLA 1-12 
UFTLK 1-12 
UFTNA 1-12 
UFTPl 1-12 
UFTP2 1-12 
UFTST 1-12 
UFTUC 1-12 



UFTUN 
UFTYD 
.UIEX 
. UPEX 



1-12 

1-12 
3-2, 3-4 
3-2, 3-8 



User File Table (UFT) l-llf,2-20ff,2-38 
user interrupts Chapter 3 

VCT 1-4 

VRTN 2-4f 

WRL 2-23f 
WRS 2-23 

XIBUF 2-29f 



INDEX-3 



